Get Carfax HTML from VIN
GET /api/carfax/vin/{vin}/html
Retrieve the complete Carfax vehicle history report as HTML for a specific VIN. This endpoint returns the full report content that can be displayed directly in a web browser or processed programmatically.
Credit Usage
This endpoint consumes 1 credit from your account balance per request.
Testing
You can use JH4DC4360SS001610 as a test VIN to preview the response format without consuming credits.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
vin | string | Yes | The 17-character Vehicle Identification Number |
Query Parameters
None.
Headers
| Key | Value |
|---|---|
x-api-key | Your API Key |
Response
Status Code: 200 OK
Response Fields
| Field | Type | Description |
|---|---|---|
yearMakeModel | string | Vehicle year, make, and model in a single string |
id | string | Unique report identifier |
html | string | Complete Carfax report as HTML markup (can be embedded in an iframe or displayed directly) |
Example Response
json
{
"yearMakeModel": "2017 TOYOTA CAMRY",
"id": "UAJNNC235345",
"html": "<html>...<script data-cfasync=\"false\" src=\"/cdn-cgi/scripts/5c5dd728/cloudflare-static/email-decode.min.js\"></script><script src=\"/cdn-cgi/scripts/7d0fa10a/cloudflare-static/rocket-loader.min.js\" data-cf-settings=\"aecaa17804c7f648298041c9-|49\" defer></script></html>"
}Error Responses
401 Unauthorized
Returned when the API key is missing or invalid.
json
{
"message": "Unauthorized"
}400 Bad Request
Returned when:
- VIN is missing or invalid
- Daily limit reached
- Insufficient credits
- Report not found (test VIN only)
json
{
"message": "VIN is required"
}json
{
"message": "VIN must be 17 characters"
}json
{
"message": "You have reached your daily limit of 20 reports"
}json
{
"message": "Insufficient credits"
}Examples
python
import requests
response = requests.get('https://panel.cheapcarfax.net/api/carfax/vin/{YOUR_VIN}/html', headers={'x-api-key': 'YOUR_API_KEY'})
print(response.json())bash
curl -X GET 'https://panel.cheapcarfax.net/api/carfax/vin/YOUR_VIN/html' \
-H 'x-api-key: YOUR_API_KEY'