Skip to content

Get User Limits Information ​

GET /api/user/limits ​

Retrieve the current usage limits and remaining quota for the authenticated user. This endpoint provides real-time information about daily request limits, remaining reports for the day, and available credits.

Use this endpoint to check quota availability before making report requests.

Path Parameters ​

None.

Query Parameters ​

None.

Headers ​

KeyValue
x-api-keyYour API Key

Response ​

Status Code: 200 OK

Response Fields ​

FieldTypeDescription
daily_limitnumberMaximum number of API requests allowed per day
carfax_reports_left_todaynumberRemaining Carfax report requests available today
autocheck_reports_left_todaynumberRemaining Autocheck report requests available today
creditsnumberTotal credits available in your account balance

INFO

Daily limits reset at midnight UTC. Credits are consumed when requesting full HTML reports.

Example Response ​

json
{
  "daily_limit": 20,
  "carfax_reports_left_today": 15,
  "autocheck_reports_left_today": 19,
  "credits": 5
}

Error Responses ​

401 Unauthorized ​

Returned when the API key is missing or invalid.

json
{
  "message": "Unauthorized"
}

Examples ​

python
import requests
response = requests.get('https://panel.cheapcarfax.net/api/user/limits', headers={'x-api-key': 'YOUR_API_KEY'})
print(response.json())
bash
curl -X GET 'https://panel.cheapcarfax.net/api/user/limits' \
-H 'x-api-key: YOUR_API_KEY'