Errors

Status	Meaning	Common cause
`200`	OK	Request succeeded
`400`	Bad Request	Missing or malformed request body / parameter
`401`	Unauthorized	Missing, invalid, or revoked API key
`402`	Payment Required	No credits remaining on the account
`422`	Unprocessable Entity	Input failed validation (e.g. invalid email format)
`429`	Too Many Requests	Rate limit exceeded — see Rate Limits
`500`	Internal Server Error	Unexpected server-side error
`503`	Service Unavailable	Upstream provider temporarily unavailable

401 — Invalid API key

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key."
}

Check that your key is correctly formatted and included in the Authorization: Bearer header.

400 — Missing required field

{
  "error": "Bad Request",
  "message": "Required field 'email' is missing from the request body."
}

Ensure your request body contains all required fields for the endpoint you are calling.

402 — Insufficient credits

{
  "error": "Payment Required",
  "message": "Insufficient credits. Top up your account or upgrade your plan."
}

Your credit balance has reached zero. Purchase a top-up from the billing page or upgrade your plan.

422 — Validation error

{
  "error": "Unprocessable Entity",
  "message": "The value provided for 'email' is not a valid email address."
}

The input passed basic format validation but failed deeper validation. Check the message field for specifics.

503 — Upstream unavailable

{
  "error": "Service Unavailable",
  "message": "One or more upstream providers are currently unavailable. Please retry shortly."
}

DataLink routes through multiple upstream providers with automatic failover. A 503 means all providers for this data type are temporarily unreachable. Check status.datalinkapis.com for live platform health.

Get Started

Core Concepts

Error response format

HTTP status codes

Common errors

​Error response format

​HTTP status codes

​Common errors

Error response format

HTTP status codes

Common errors