Errors
Every error has the same shape and a code from one closed list. Branch on error.code. The message is for people and may change.
Every code
| Status | Code | Means | Retry |
|---|---|---|---|
| 404 | not_found | No such resource, or not yours. Also answered while the endpoint is not turned on for you. Never 403: whether another buyer's resource exists is not disclosed. | No |
| 401 | unauthenticated | Signed out, or the credential was not accepted: an access token that is not valid, or an Authorization header that is not a Ridekick access token. | After signing in |
| 503 | auth_unverifiable | Sign-in could not be confirmed. This is not the same as signed out. | Yes, with backoff |
| 503 | unavailable | The service did not answer right now, so nothing was returned or sent. Try again in a moment, and wait the number of seconds in Retry-After when it is present. | Yes, with backoff |
| 429 | rate_limited | Too many requests from this principal in the window. | After Retry-After |
| 403 | insufficient_scope | The credential does not include the scope this endpoint needs. The WWW-Authenticate header names the required scope. | No |
| 400 | invalid_request | The request body or a header failed validation. An out-of-range value is refused, not adjusted: what you asked is never silently changed. | No |
| 500 | internal | Something failed on our side. The response carries no data. | Yes, with backoff |
Headers on every answer
| Header | Value |
|---|---|
Cache-Control | private, no-store |
Ridekick-API-Version | 2026-10-13 |
Last updated