Problem Details
RFC 9457 error bodies returned by API operations.
HTTP status
| Status | Meaning | Retry |
|---|---|---|
400 | Invalid request, parameter, or cursor | No |
401 | Missing, malformed, or revoked credentials | No |
402 | Insufficient organisation credit | After top-up |
403 | Insufficient scope or disallowed origin | No |
404 | Resource unavailable to this organisation | No |
408 | The server did not complete the request in time | Yes |
429 | Organisation request rate exceeded | After Retry-After |
503 | Service or usage accounting unavailable | Only when retryable |
Error codes
Stable code values on RFC 9457 Problem Details bodies.
| Code | Status | Retryable | When | Example param |
|---|---|---|---|---|
invalid_request | 400 | No | The query cannot be processed as a whole, including conflicting ranges. | — |
invalid_value | 400 | No | A parameter is the wrong type, fails its format, or is not an allowed enum value. | query |
too_large | 400 | No | A numeric, string, or collection parameter exceeds its documented maximum. | roles |
too_small | 400 | No | A numeric, string, or collection parameter is below its documented minimum. | query |
unknown_parameter | 400 | No | The query includes a name that is not part of the operation contract. | unknown |
duplicate_parameter | 400 | No | A scalar query parameter is sent more than once. | query |
invalid_cursor | 400 | No | The cursor is expired, tampered with, or bound to different filters. | paginationToken |
invalid_api_key | 401 | No | The Authorization Bearer token is missing, malformed, expired, or revoked. | — |
invalid_access_token | 401 | No | An OAuth access token used for MCP is missing, malformed, or no longer valid. | — |
insufficient_credits | 402 | No | The organisation wallet cannot fund the maximum resources requested. | — |
insufficient_scope | 403 | No | The credential does not grant the scope required by the operation. | — |
invalid_origin | 403 | No | A browser request did not come from the Luranta documentation origin. | — |
not_found | 404 | No | The requested job or company does not exist or is not commercially available. | — |
rate_limit_exceeded | 429 | Yes | The organisation exceeded its shared request rate. Honour Retry-After. | — |
service_unavailable | 503 | Yes | Authentication or the data plane could not complete the request safely. | — |
usage_unavailable | 503 | Yes | The request could not be accounted for safely. No data was returned. | — |
Example
{
"type": "https://docs.luranta.com/errors/invalid-request",
"title": "Invalid request",
"status": 400,
"detail": "The query cannot be processed as a whole, including conflicting ranges.",
"instance": "/v0/jobs",
"code": "invalid_request",
"request_id": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
"retryable": false
}ProblemDetails
Identity
titlestringrequired
Range:
Maximum length 120Minimum length 11120typestringrequired
Format:
uriMaximum length:
Format uriMaximum length 20482048Errors
errorsobject[]required
Range:
Maximum items 100Minimum items 11100codestringrequired
Range:
Maximum length 80Minimum length 1180messagestringrequired
Range:
Maximum length 500Minimum length 11500pointerstringrequired
Format:
starts_withPattern:
Format starts_withPattern ^\/.*^\/.*availableCreditUsdstringoptional
Pattern:
Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$^(?:0|[1-9]\d*)\.\d{2,6}$codestringrequired
Range:
Maximum length 80Minimum length 1180detailstringrequired
Range:
Maximum length 1000Minimum length 111000instancestringrequired
Format:
starts_withPattern:
Format starts_withPattern ^\/.*^\/.*paramstringoptional
Range:
Maximum length 160Minimum length 11160requestIdstringrequired
Format:
uuidPattern:
Format uuidPattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$requiredCreditUsdstringoptional
Pattern:
Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$^(?:0|[1-9]\d*)\.\d{2,6}$retryablebooleanrequired
statusintegerrequired
Range:
Maximum 599Minimum 400400599topUpUrlstringoptional
Format:
uriMaximum length:
Format uriMaximum length 20482048