Skip to main content
All error responses include a detail field with specific context.
When reporting an error to support@nippy.la, include the request_id, the detail field, and the action you were running.

​
HTTP codes

Cause: The API key is missing, misspelled, or doesn’t use the npk_ prefix.Fix: Send the X-API-Key header with a valid key.
Cause: The key doesn’t have permissions for the vertical, tool, or resource requested.Fix: Review permissions from the console and confirm the resource belongs to your business.
Cause: The client sent too many requests in a short period.Fix: Wait a few seconds and spread calls over time.
Cause: An internal error occurred while executing the request.Fix: Retry later. If it persists, report the request_id.

​
Common tool errors

Cause: The key is not tied to a specific business.Fix: Use an npk_* API key created from https://console.nippy.la/settings/api-keys.
Cause: No data for the date range or the queried area does not contain that type of information.Fix: Try a wider range and confirm the queried collection is correct.
Cause: The roulette ID doesn’t exist or belongs to another business.Fix: Use roulettes_list_roulettes to get valid IDs.
Cause: The center, product, or stock doesn’t pass server validation.Fix: Verify IDs with supply_list_nippy_centers and supply_list_nippy_center_stocks before retrying.