Rate Limiting and Thresholds

An example API guitar catalog website

Overview

Rate limits determine how frequently you can call a particular endpoint. We provide these rate limit plans:

Plan Free Tier 1 Tier 2
Price Free $50 USD/Month $250 USD/Month
Subscribe Get API Key and Start Subscribe Subscribe
Max calls per hour* 500 2,500 10,000

*Maximum calls per hour applies to each API resource we deliver. For example, if you are a Tier 1 subscriber, you receive 2,500 API calls to each API resource we deliver, per hour.

API rate limits reset once each hour. If you are experiencing rate limiting errors, please wait 60 minutes to resume making API calls. You can view your rate limit status in API HTTP response headers or using our delivered Rate Limit API.

If you’re a high-volume user of the Arizona Classic Cars API, please contact us to discuss additional options.

Obtaining Rate Limit Status

You can obtain and view your rate limit status in API HTTP response headers or using our Rate Limit API.

HTTP response header information is limited to a single resource; the Rate Limit API returns information for all Arizona Classic Vehicles resources.

Note that reset timestamps returned in all responses are in UTC epoc seconds.

Response Headers

The HTTP response header of any API request shows your current rate limit status:

X-RateLimit-Resource: cars

X-RateLimit-Limit: 2500

X-RateLimit-Remaining: 902

X-RateLimit-Reset: <timestamp>

Header Name Description
X-RateLimit-Resource The name of the resource for which rate limit status is being returned.
X-RateLimit-Limit The maximum number of requests you’re permitted to make per hour.
X-RateLimit-Remaining The number of requests remaining in the current rate limit window.
X-RateLimit-Reset The time at which the current rate limit window resets in UTC epoch seconds.

Rate Limit API

Arizona Classic Vehicles provides an API that returns the status of your current rate limit status for all of our resouces.

GET /rate_limit_status

Returns the current rate limits for Arizona Classic Vehicles resources.

Resource URL

http://azvehicles.com/rate_limit_status.json

Example Request and Response

Example Request
GET http://azvehicles.com/rate_limit_status.json?resources=cars,motorcycles
Example Response
{
  "rate_limit_context": {
  "access_token": "786491-24zE39NUezJ8UTmOGOtLhgyLgCkPyY4dAcx6NA6sDKw"
  },
  "resources": {
    "cars": {
        "limit": 2500,
        "remaining": 902,
        "reset": 1536955200
      },
   "motorcycles": {
        "limit": 2500,
        "remaining": 2500,
        "reset": 1536955200
      },
        . . .  
  }
}

Rate Limit Errors

If you exceed your plan rate limit you will receive the following HTTP error: 403 Forbidden.

If you are experiencing rate limiting errors, please wait 60 minutes to resume making API calls.