Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt

Use this file to discover all available pages before exploring further.

HTTP status codes tell you whether your request succeeded, failed authentication, hit a rate limit, or needs a corrected payload. This page covers the status codes you are most likely to see when calling the Seamless v1 REST API.
Poll status values such as done, error, or duplicate are not HTTP errors — they appear in a 200 response body when you call a poll endpoint. See Authenticate and make your first request for poll status meanings.

​
Status code reference

HTTP statusMeaningTypical causeWhat to do
400Bad requestInvalid or missing parameters in the request body or query stringFix the request payload and compare with the endpoint reference
401UnauthorizedMissing, invalid, expired, or revoked API key or access tokenConfirm the Token or Authorization: Bearer header; rotate or refresh credentials — see API keys or OAuth
403ForbiddenOAuth connection lacks required permission (insufficientScope)Re-authorize with scope publicAPI.v1.all — see OAuth
404Not foundWrong URL or pathConfirm the base URL https://api.seamless.ai/api/client/v1/... and endpoint path
422UnprocessableInsufficient credits or missing license — see 422 details belowFix credits or license — see Rate limits and credits
429Too many requestsRate limit exceeded (rateLimitExceeded)Wait until X-RateLimit-Reset — see Rate limits and credits
500Server errorUnexpected platform errorRetry with backoff; contact support if it persists
202AcceptedResearch request queued successfully (not an error)Save requestIds and poll or use webhooks

​
422: insufficient credits vs missing license

Both problems return HTTP 422, but the code field in the JSON body tells you which one applies:
codeMeaningWhat to do
insufficientCreditsYour account does not have enough research credits for this requestCheck Settings → Billing in the Seamless app or the X-PublicAPI-Credits response header; reduce batch size or add credits
missingLicenseYour account does not have an active Public API licenseContact your Seamless administrator or support to enable Public API access
Example — insufficient credits: 
{
  "code": "insufficientCredits",
  "msg": "Insufficient credit amount."
}
Example — missing license: 
{
  "code": "missingLicense",
  "msg": "Public API requires an active license."
}

​
429: rate limit exceeded

When you exceed your organization’s rate limit, the API returns 429 with a JSON body similar to: 
{
  "code": "rateLimitExceeded",
  "message": "Rate limit exceeded. Please wait and try again."
}
Read X-RateLimit-Reset from the response headers and wait until that time before retrying the same endpoint.