CARFAX listing by VIN API

Use the CARFAX listing by VIN API to retrieve price information, equipment and features, price history, vehicle identification, model identification and fee breakdowns as structured JSON from CARFAX. Choose vehicle identification number and source-page URL as optional query conditions to select the source records or view required for your request. Use these results to inspect a vehicle advertisement and organize its specifications, price and seller context for comparison. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Optional parameters (8)
17-character VIN, e.g. `WAUDAAF46NN004690`.
A carfax.com/vehicle/<VIN> link.
`true`: the first car of CARFAX's Toyota page (when no VIN is given).
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.

Sample response

{
  "bed_length": null,
  "body_style": "SUV",
  "breadcrumbs": [
    {
      "label": "Home",
      "url": "https://www.carfax.com"
    },
    {
      "label": "Used Cars",
      "url": "https://www.carfax.com/cars-for-sale"
    },
    {
      "label": "Toyota RAV4",
      "url": "https://www.carfax.com/Used-Toyota-RAV4_w638"
    },
    {
      "label": "2022",
      "url": "https://www.carfax.com/Used-2022-Toyota-RAV4_z38752"
    },
    {
      "label": "XLE",
      "url": "https://www.carfax.com/Used-2022-Toyota-RAV4-XLE_x50479"
    },
    {
      "label": "Elmira, NY",
      "url": null
    }
  ],
  "cab_type": null,
  "cached": false,
  "certified": null,
  "condition": "USED",
  "credits_used": 1,
  "deal_rating": "GREAT",
  "dealer": {
    "address": "1074 County Road 64",
    "city": "Elmira",
    "distance_miles": 0,
    "doc_fee": 175,
    "id": "OOZDVPH001",
    "latest_review": "I had a great experience at Williams Toyota of Elmira. The oil change was completed quickly and professionally, and the staff was friendly and courteous throughout the visit. I highly recommend Williams Toyota of Elmira for vehicle service and maintenance.",
    "latest_review_date": "2026-10-26 12:49:40",
    "latitude": 42.15845,
    "longitude": -76.8627,
    "name": "Williams Toyota of Elmira",
    "phone": "(607) 414-6967",
    "rating": 4.7,
    "review_count": 103,
    "reviews_url": "https://www.carfax.com/Reviews-Williams-Toyota-of-Elmira-Elmira-NY_OODZVPH001",
    "state": "NY",
    "website": "http://www.williamstoyotaofelmira.com",
    "zip": "14903"
  },
  "displacement": "2.5 L",
  "drive": "AWD",
  "engine": "4 Cyl",
  "exterior_color": "White",
  "features": [
    "4-Wheel Disc Brakes",
    "5-Passenger Seating",
    "AM/FM",
    "Adaptive Cruise Control",
    "Adjustable Steering Wheel",
    "Air Conditioning",
    "All-Season Tires",
    "Anti-Lock Brakes",
    "Automatic Headlights",
    "Aux Audio Adapter",
    "Braking Assist",
    "Child Safety Locks",
    "Cloth Seats",
    "Collision Warning System",
    "Compact Spare Tire",
    "Cross Traffic Alert",
    "Daytime Running Lights",
    "Driver Adjustable Lumbar",
    "Engine Immobilizer",
    "Front Airbags (Driver)",
    "Front Airbags (Passenger)",
    "Front Head Airbag",
    "Front Knee Airbags (Driver)",
    "Front Side Airbags (Driver)",
    "HD Radio",
    "Handsfree/Bluetooth Integration",
    "Intermittent Wipers",
    "Keyless Ignition",
    "Lane Keeping System",
    "Multi-Zone Climate Control",
    "Pass-Through Rear Seat",
    "Passenger Sensing Airbag",
    "Power Locks",
    "Power Mirrors",
    "Power Seat (Dual)",
    "Power Steering",
    "Power Windows",
    "Privacy Glass",
    "Rear Bench Seat",
    "Rear Head Airbags",
    "Rear Spoiler",
    "Rear Window Defroster",
    "Rear-View Camera",
    "Remote Trunk Release",
    "Smart Device Integration",
    "Stability Control",
    "Steering Wheel Controls",
    "Telematics System",
    "Tire Pressure Monitoring System",
    "Traction Control",
    "Trip Computer",
    "Turn Signal Mirrors",
    "Vanity Mirror/Light",
    "Wi-Fi Hotspot"
  ],
  "fees": [
    {
      "amount": 175,
      "type": "document_fee"
    },
    {
      "amount": 175,
      "type": "Document & Other Fees"
    }
  ],
  "fetched_at": "2026-11-19T12:26:52.623Z",
  "first_seen": "2026-11-07",
  "followers": 7,
  "fuel": "Gasoline",
  "history": {
    "accident": "No accident or damage reported to CARFAX",
    "details": {
      "accidentHistory": {
        "accidentSummary": [
          "No accident/damage reported to CARFAX"
        ],
        "icon": "noAccident",
        "iconName": "checkmarkSquareColor",
        "iconUrl": "https://media.carfax.com/img/vhr/ico_noAccident.gif",
        "summary": "No accident or damage reported to CARFAX",
        "text": "No Accident or Damage Reported"
      },
      "ownerHistory": {
        "history": [
          {
            "city": "Corning",
            "endOwnershipDate": "08/24/26",
            "ownerNumber": 1,
            "purchaseDate": "02/23/22",
            "state": "NY"
          }
        ],
        "icon": "owner1",
        "iconName": "scallopedCircleOneColor",
        "iconUrl": "https://media.carfax.com/img/vhr/ico_owner1.gif",
        "summary": "Purchased on 02/23/22 and owned in NY until 08/24/26",
        "text": "CARFAX 1-Owner"
      },
      "serviceHistory": {
        "history": [
          {
            "city": "Elmira",
            "date": "10/12/26",
            "description": "Vehicle serviced <span class='bullet' style='font-weight: bold;'>&#8226;</span> Battery/charging system checked <span class='bullet' style='font-weight: bold;'>&#8226;</span> Battery replaced <span class='bullet' style='font-weight: bold;'>&#8226;</span> Emissions inspection performed <span class='bullet' style='font-weight: bold;'>&#8226;</span> Emissions or safety inspection performed <span class='bullet' style='font-weight: bold;'>&#8226;</span> Safety inspection performed.",
            "odometerReading": 115139,
            "source": "Williams Toyota of Elmira, Elmira, NY, ",
            "state": "NY"
          }
        ],
        "icon": "service",
        "iconName": "toolsColor",
        "iconUrl": "https://media.carfax.com/img/vhr/ico_service.gif",
        "number": 21,
        "summary": "Last serviced at 115,139 miles in Elmira, NY on 10/12/26 &bull; Vehicle serviced <span class='bullet' style='font-weight: bold;'>&#8226;</span> Battery/charging system checked <span class='bullet' style='font-weight: bold;'>&#8226;</span> Battery replaced <span class='bullet' style='font-weight: bold;'>&#8226;</span> Emissions inspection performed <span class='bullet' style='font-weight: bold;'>&#8226;</span> Emissions or safety inspection performed <span class='bullet' style='font-weight: bold;'>&#8226;</span> Safety inspection performed.",
        "text": "Service History"
      },
      "vehicleUseHistory": {
        "history": [
          {
            "averageMilesPerYear": 25373,
            "ownerNumber": 1,
            "useType": "Personal Use"
          }
        ],
        "icon": "personal",
        "iconName": "houseColor",
        "iconUrl": "https://media.carfax.com/img/vhr/ico_personal.gif",
        "summary": "Driven an estimated 25,373  miles/year.",
        "text": "Personal Use"
      }
    },
    "highlights": [
      "No Accidents or Damage Reported to CARFAX",
      "<strong>21</strong> Service History Records",
      "CARFAX 1-Owner Vehicle",
      "Personal Vehicle",
      "Last Owned in New York",
      "<strong>115,139</strong> Last Reported Odometer Reading"
    ],
    "no_accidents_reported": true,
    "one_owner": true,
    "owners": "CARFAX 1-Owner",
    "owners_summary": "Purchased on 02/23/22 and owned in NY until 08/24/26",
    "personal_use": true,
    "report_url": "https://www.carfax.com/vehiclehistory/ccl/adE1fiWGd5caaurBfWnt1f3T6_tJZKzrDzD7WxdFxm_LEDVHkDz8_blWmepjLlpuQLFbmT7jl3bMISBWbwWujUkYr0ligOPDM4gMrhv7",
    "service": "Service History",
    "service_count": 21,
    "service_records": true,
    "service_summary": "Last serviced at 115,139 miles in Elmira, NY on 10/12/26 &bull; Vehicle serviced <span class='bullet' style='font-weight: bold;'>&#8226;</span> Battery/charging system checked <span class='bullet' style='font-weight: bold;'>&#8226;</span> Battery replaced <span class='bullet' style='font-weight: bold;'>&#8226;</span> Emissions inspection performed <span class='bullet' style='font-weight: bold;'>&#8226;</span> Emissions or safety inspection performed <span class='bullet' style='font-weight: bold;'>&#8226;</span> Safety inspection performed.",
    "use": "Personal Use",
    "use_summary": "Driven an estimated 25,373  miles/year."
  },
  "id": "2T3P1RFV4NC266791OOZDVPH00120261107",
  "image_count": 29,
  "images": [
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/1/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/2/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/3/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/4/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/5/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/6/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/7/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/8/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/9/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/10/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/11/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/12/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/13/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/14/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/15/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/16/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/17/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/18/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/19/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/20/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/21/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/22/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/23/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/24/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/25/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/26/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/27/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/28/640x480",
    "https://carfax-img.vast.com/carfax/v2/-6039137057961596907/29/640x480"
  ],
  "interior_color": "Black",
  "list_price": 21674,
  "make": "Toyota",
  "mileage": 115119,
  "model": "RAV4",
  "monthly_payment": 371,
  "mpg_city": 25,
  "mpg_combined": 28,
  "mpg_highway": 33,
  "msrp": null,
  "no_longer_available": false,
  "one_price": {
    "difference": "$2,476 below",
    "value": "$24,150"
  },
  "price": 21674,
  "price_history": [],
  "seller_comments": "CARFAX One-Owner. Clean CARFAX.AWD 8-Speed Automatic 2.5L 4-Cylinder DOHC Dual VVT-i27/33 City/Highway MPGThis vehicle comes with a one-year pre-paid maintenance package, up to a $290 value! This complimentary package provides you with two pre-paid vehicle maintenance services, one year of roadside assistance and select coupon offers tailored to your vehicle. Some mileage and vehicle restrictions apply, see dealer for full details. Please visit https://www.nhtsa.gov/ to see if this vehicle has any open manufacturer recalls.",
  "stock_number": "WT6065A",
  "sub_trim": null,
  "title": "2022 Toyota RAV4 XLE",
  "top_features": [
    "Keyless Entry",
    "Cargo Cover",
    "Bucket Seats",
    "Blind Spot Monitor",
    "Alloy Wheels",
    "Led Lights",
    "Limited Slip Differential",
    "Lane Departure Warning",
    "Heated Mirrors",
    "Satellite Radio"
  ],
  "transmission": "Automatic",
  "trim": "XLE",
  "url": "https://www.carfax.com/vehicle/2T3P1RFV4NC266791",
  "vehicle_price": 21499,
  "vin": "2T3P1RFV4NC266791",
  "year": 2022
}

Response result

Response structure

Inferred from examples
  • bed_lengthnull
  • body_stylestring
  • breadcrumbsobject[]
    • labelstring
    • urlstring | null
  • cab_typenull
  • cachedboolean
  • certifiednull
  • conditionstring
  • credits_usedinteger
  • deal_ratingstring
  • dealerobject
    • addressstring
    • citystring
    • distance_milesinteger
    • doc_feeinteger
    • idstring
    • latest_reviewstring
    • latest_review_datestring
    • latitudenumber
    • longitudenumber
    • namestring
    • phonestring
    • ratingnumber
    • review_countinteger
    • reviews_urlstring
    • statestring
    • websitestring
    • zipstring
  • displacementstring
  • drivestring
  • enginestring
  • exterior_colorstring
  • featuresstring[]
  • feesobject[]
    • amountinteger
    • typestring
  • fetched_atstring
  • first_seenstring
  • followersinteger
  • fuelstring
  • historyobject
    • accidentstring
    • detailsobject
      • accidentHistoryobject
        • accidentSummarystring[]
        • iconstring
        • iconNamestring
        • iconUrlstring
        • summarystring
        • textstring
      • ownerHistoryobject
        • historyobject[]
          • citystring
          • endOwnershipDatestring
          • ownerNumberinteger
          • purchaseDatestring
          • statestring
        • iconstring
        • iconNamestring
        • iconUrlstring
        • summarystring
        • textstring
      • serviceHistoryobject
        • historyobject[]
          • citystring
          • datestring
          • descriptionstring
          • odometerReadinginteger
          • sourcestring
          • statestring
        • iconstring
        • iconNamestring
        • iconUrlstring
        • numberinteger
        • summarystring
        • textstring
      • vehicleUseHistoryobject
        • historyobject[]
          • averageMilesPerYearinteger
          • ownerNumberinteger
          • useTypestring
        • iconstring
        • iconNamestring
        • iconUrlstring
        • summarystring
        • textstring
    • highlightsstring[]
    • no_accidents_reportedboolean
    • one_ownerboolean
    • ownersstring
    • owners_summarystring
    • personal_useboolean
    • report_urlstring
    • servicestring
    • service_countinteger
    • service_recordsboolean
    • service_summarystring
    • usestring
    • use_summarystring
  • idstring
  • image_countinteger
  • imagesstring[]
  • interior_colorstring
  • list_priceinteger
  • makestring
  • mileageinteger
  • modelstring
  • monthly_paymentinteger
  • mpg_cityinteger
  • mpg_combinedinteger
  • mpg_highwayinteger
  • msrpnull
  • no_longer_availableboolean
  • one_priceobject
    • differencestring
    • valuestring
  • priceinteger
  • price_historyunknown[]
  • seller_commentsstring
  • stock_numberstring
  • sub_trimnull
  • titlestring
  • top_featuresstring[]
  • transmissionstring
  • trimstring
  • urlstring
  • vehicle_priceinteger
  • vinstring
  • yearinteger

Loading related APIs…

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use CARFAX listing by VIN API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.