Skip to content
carsagecarsage

← Documentation

Errors & rate limits

Standard HTTP status codes and plan rate limits. Response bodies follow { statusCode, message, error } once product API is live.

Rate limits by plan

PlanLimit
Starter5 requests / second
Build15 requests / second
Ship30 requests / second
Scale50 requests / second
Bulk100 requests / second
Enterprise100 requests / second

HTTP error codes

  • 400Bad Request

    Invalid VIN, missing parameter, or malformed request body.

  • 401Unauthorized

    Missing or invalid API key.

  • 403Forbidden

    No active subscription, or organization is not allowed to call the API.

  • 404Not Found

    Resource not found (unknown VIN, plate, etc.).

  • 429Too Many Requests

    Rate limit or monthly token allowance exceeded. Retry after the period indicated in Retry-After.

  • 502Bad Gateway

    Upstream data provider temporarily unavailable.

  • 503Service Unavailable

    Planned maintenance or overload. Check /status.

Pricing and included volumes: compare plans.