Enterprise API documentation

curl -X POST https://carmareports.com/api/v1/fullreport \
  -H "Authorization: Bearer crk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin": "1HGCM82633A004352"}'

{
  "report_id": "cml7x2ab40001rt9k",
  "status": "complete",
  "tier": "basic",
  "vin": "1HGCM82633A004352",
  "cached": false,
  "generated_at": "2026-07-29T18:04:11.000Z",
  "report": {
    "vin": "1HGCM82633A004352",
    "generatedAt": "2026-07-29T18:04:11.000Z",
    "vehicle": {
      "year": 2015, "make": "Jeep", "model": "Grand Cherokee",
      "trim": "Limited", "bodyStyle": "SUV", "engine": "3.6L V6",
      "transmission": "Automatic", "fuelType": "Gasoline",
      "exteriorColor": "Granite Crystal", "msrpCents": 4139500
      /* …plus drive type, MPG, doors, seating, origin */
    },
    "mileage": { "lastReported": 87450, "lastReportedDate": "2026-03-14", "estimated": 91200 },
    "scores": { "carmaScore": 82, "condition": "Good", "riskScore": 24, "riskLabel": "Low risk" },
    "summary": { /* accident / title-brand / odometer flags */ },
    "market": { "estimateCents": 1650000, "lowCents": 1480000, "highCents": 1820000 },
    "timeline":         [ /* chronological history events */ ],
    "brandChecks":      [ /* salvage, flood, lemon, junk checks */ ],
    "odometerReadings": [ /* dated readings with source */ ],
    "accidents":        [ /* date, severity, impact area, est. damage */ ],
    "titleBrands":      [ /* brand code, description, state, date */ ],
    "salesRecords":     [ /* historical listings and sale prices */ ],
    "recalls":          [ /* open recall campaigns */ ],
    "findings":         [ /* notable findings with severity */ ]
    /* Intelligent tier adds an "aiEnhanced" block: web findings,
       image assessment, valuation, and a buyer verdict. */
  }
}

{
  "error": {
    "code": "vehicle_not_found",
    "message": "No vehicle-history data was found for this VIN."
  }
}

const BASE = "https://carmareports.com/api/v1";
const KEY = process.env.CARMA_API_KEY; // crk_live_…

async function getFullReport(vin) {
  const res = await fetch(`${BASE}/fullreport`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ vin }),
  });

  if (res.status === 200) return res.json();          // ready now

  if (res.status === 202) {                           // still generating — poll
    const { report_id } = await res.json();
    while (true) {
      await new Promise((r) => setTimeout(r, 3000));
      const poll = await fetch(`${BASE}/reports/${report_id}`, {
        headers: { Authorization: `Bearer ${KEY}` },
      });
      if (poll.status === 200) return poll.json();
      if (poll.status !== 202) throw new Error(`Report failed: ${poll.status}`);
    }
  }

  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message}`);
}

const report = await getFullReport("1HGCM82633A004352");
console.log(report.report.vehicle, report.report.scores);

import os, time, requests

BASE = "https://carmareports.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['CARMA_API_KEY']}"}

def get_full_report(vin: str, tier: str = "basic") -> dict:
    res = requests.post(f"{BASE}/fullreport", headers=HEADERS,
                        json={"vin": vin, "tier": tier}, timeout=90)
    if res.status_code == 200:
        return res.json()                       # ready now
    if res.status_code == 202:                  # still generating — poll
        report_id = res.json()["report_id"]
        while True:
            time.sleep(3)
            poll = requests.get(f"{BASE}/reports/{report_id}",
                                headers=HEADERS, timeout=30)
            if poll.status_code == 200:
                return poll.json()
            if poll.status_code != 202:
                poll.raise_for_status()
    res.raise_for_status()

report = get_full_report("1HGCM82633A004352")
print(report["report"]["vehicle"], report["report"]["scores"])