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'