API Documentation
Welcome to the Car Simulcast API Documentation. Our REST API allows you to integrate vehicle history reports directly into your applications. All report data is returned as a Base64-encoded string. To view the report, simply decode the Base64 output on your end.
Getting Started: Create an account to receive your API keys.
Test VIN:
1C6RD6FT1CS310366
Main Endpoints
GET
Records Check
https://connect.carsimulcast.com/checkrecords/{VIN}
GET
Comprehensive Report
https://connect.carsimulcast.com/getrecord/carfax/{VIN}
GET
Alternative Report
https://connect.carsimulcast.com/getrecord/autocheck/{VIN}
Optional Endpoints
GET
Check Balance
https://connect.carsimulcast.com/balance
GET
Locate Old Report
https://connect.carsimulcast.com/archive/{vin}
GET
Auctions Report
https://connect.carsimulcast.com/getrecord/auctions/{VIN}
GET
Window Sticker (PDF)
https://connect.carsimulcast.com/getrecord/sticker/{VIN}
Requires PDF headers in request
GET
Convert License Plate to VIN
https://connect.carsimulcast.com/checkplate/{state}/{plate_no}
State must be abbreviated (e.g., CA, NY, TX)
POST
Convert Image to VIN
https://connect.carsimulcast.com/scan
Send image file as 'file' parameter
POST
Convert Reports to PDF
https://connect.carsimulcast.com/pdf
Send reports base64 and VIN
GET Request Example
PHP CURL
<?php
$api_url = "https://connect.carsimulcast.com/checkrecords/{VIN}";
$header = array(
"API-KEY: {Your API_KEY}",
"API-SECRET: {Your API_SECRET}",
);
$curl = curl_init($api_url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
Window Sticker Example (PDF)
For Window Sticker endpoint, you must include PDF headers before making the request:
Window Sticker - PHP CURL
<?php
// Get the base64-encoded PDF from API
$api_url = "https://connect.carsimulcast.com/getrecord/sticker/{VIN}";
$header = array(
"API-KEY: YOUR_API_KEY",
"API-SECRET: YOUR_API_SECRET",
);
$curl = curl_init($api_url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
$response = curl_exec($curl);
curl_close($curl);
// ⭐ DECODE the base64 response
$pdf = base64_decode($response);
// Now output as PDF
header("Content-type: application/pdf");
header("Content-Disposition: inline; filename=window_sticker.pdf");
echo $pdf;
?>
POST Request Example
Image Scan - PHP CURL
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://connect.carsimulcast.com/scan",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array(
"file" => new CURLFILE("/path/to/image.jpg")
),
CURLOPT_HTTPHEADER => array(
"API-KEY: {Your API_KEY}",
"API-SECRET: {Your API_SECRET}"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>