DocsGetting StartedErrors & Rate Limits

Errors & Rate Limits

Understand HTTP response status codes, error models, and rate limit quotas.

Updated: July 20261 min read

HTTP Status Codes

AddressValid uses standard HTTP response codes to indicate success or failure:

  • 200 OK: Request succeeded.
  • 400 Bad Request: Invalid parameters or missing required query string.
  • 401 Unauthorized: Missing or invalid API key.
  • 429 Too Many Requests: Rate limit exceeded.
  • 500 Internal Server Error: Platform execution error.

Rate Limit Response Headers

Every API response includes rate limiting telemetry headers:

1
2
3
x-ratelimit-limit: 1000 x-ratelimit-remaining: 994 x-ratelimit-reset: 1785084920

Was this documentation page helpful?

Your feedback helps us continuously improve our developer docs.

© 2026 AddressValid Inc. All rights reserved. Global Address Intelligence & Location Infrastructure.