# Vehicle VIN, Safety, Fuel Economy & On-Time API > Validate VIN check digits, decode VINs from vendored NHTSA vPIC data, look up NHTSA recalls and 5-Star ratings, EPA fuel economy, UK Vehicle Excise Duty rates, and BTS airline on-time performance. All list lookups read committed snapshots; no live vendor HTTP at request time. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/vehicle-transport - Docs: https://www.brainiac.software/api/vehicle-transport/docs - OpenAPI: https://www.brainiac.software/api/vehicle-transport/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/vehicle-transport/vin-check-digit-validate $0.01 USDC. Validate the structure and 9th-position check digit of a 17-character VIN and read model-year code candidates from 49 CFR Part 565. Pure computation; no network. Inputs: vin Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-vin-check-digit-validate Example request: ```json { "vin": "1HGCM82633A004352" } ``` Example response: ```json { "vin": "1HGCM82633A004352", "valid": true, "length": 17, "invalidCharacters": [], "checkDigit": { "expected": "3", "actual": "3", "matches": true }, "wmi": "1HG", "vds": "CM826", "vis": "3A004352", "modelYearCode": "3", "modelYearCandidates": [ 2003, 2033 ] } ``` ### POST /api/v1/vehicle-transport/vin-decode $0.03 USDC. Decode a VIN to make, model, year, body, engine and plant fields from the vendored NHTSA vPIC standalone database. No live vPIC API call. Inputs: vin, modelYear?, includeAll? Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-vin-decode Example request: ```json { "vin": "4T1DBADK7SU506283" } ``` Example response: ```json { "vin": "4T1DBADK7SU506283", "errorCodes": [ 0 ], "errorText": [ "0 - VIN decoded clean. Check Digit (9th position) is correct" ], "decoded": { "make": "TOYOTA", "manufacturerName": "TOYOTA MOTOR MANUFACTURING, KENTUCKY, INC.", "model": "Camry", "modelYear": 2025 }, "snapshot": "vPICList_lite_2026_11" } ``` ### POST /api/v1/vehicle-transport/nhtsa-recall-by-vin $0.03 USDC. List NHTSA safety recall campaigns filed since 2010 for a VIN (decoded locally) or make/model/year from the vendored ODI flat file. Inputs: vin?, make?, model?, modelYear?, recallType?, limit?, includeUnknownYear? Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-nhtsa-recall-by-vin Example request: ```json { "vin": "1HGCM82633A004352" } ``` Example response: ```json { "query": { "make": "HONDA", "model": "ACCORD", "modelYear": 2003, "fromVin": true }, "count": 12, "recalls": [ { "campaignNumber": "15V320000", "recallType": "vehicle", "potentiallyAffected": 6281043 } ], "snapshotDate": "2026-11-14" } ``` ### POST /api/v1/vehicle-transport/nhtsa-safety-ratings $0.02 USDC. Return NHTSA Safercar 5-Star Safety Ratings and listed safety equipment for a make, model and model year from the vendored Safercar file. Inputs: make?, model?, modelYear?, driveTrain?, bodyStyle?, vin? Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-nhtsa-safety-ratings Example request: ```json { "make": "TOYOTA", "model": "CAMRY HYBRID", "modelYear": 2025 } ``` Example response: ```json { "count": 2, "variants": [ { "make": "TOYOTA", "model": "CAMRY HYBRID", "modelYear": 2025, "overallStars": 5, "driveTrain": "AWD" } ], "snapshotDate": "2026-11-14" } ``` ### POST /api/v1/vehicle-transport/epa-fuel-economy-lookup $0.02 USDC. Return EPA fuel-economy, CO2 and annual fuel-cost figures (and EV range/consumption) from the vendored fueleconomy.gov vehicle file. Inputs: year, make, model?, baseModel?, drive?, limit? Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-epa-fuel-economy-lookup Example request: ```json { "year": 2025, "make": "Toyota", "baseModel": "Camry" } ``` Example response: ```json { "count": 5, "vehicles": [ { "id": 48032, "year": 2025, "make": "Toyota", "model": "Camry HEV FF LE", "mpg": { "city": 53, "highway": 50, "combined": 51 } } ], "snapshotDate": "2026-11-14" } ``` ### POST /api/v1/vehicle-transport/uk-ved-rate-lookup $0.01 USDC. Compute UK Vehicle Excise Duty for cars, vans, motorcycles and tricycles for the rate year 1 April 2026 – 31 March 2027 from GOV.UK rate tables in code. Inputs: category, firstRegistered, taxDate?, payment, fuel?, co2GPerKm?, dieselMeetsRde2?, listPricePence?, engineCc?, euroStandard? Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-uk-ved-rate-lookup Example request: ```json { "category": "car", "firstRegistered": "2025-05-01", "payment": "renewal", "fuel": "petrol", "co2GPerKm": 120, "listPricePence": 4500000, "taxDate": "2026-05-01" } ``` Example response: ```json { "rule": "car registered on or after 1 April 2017: standard rate + expensive car supplement", "ratesPence": { "twelveMonths": 64000, "twelveMonthsDirectDebit": 64000, "twelveMonthlyDirectDebitTotal": 67200, "sixMonths": 35200, "sixMonthsDirectDebit": 33600 }, "expensiveCarSupplementApplied": true } ``` ### POST /api/v1/vehicle-transport/bts-ontime-lookup $0.02 USDC. Return official on-time, cancellation and diversion counts for a US carrier, airport or route from vendored BTS Reporting Carrier On-Time Performance aggregates (Sep 2025 – Aug 2026). Inputs: carrier?, origin?, dest?, year?, month?, groupBy? Docs: https://www.brainiac.software/api/vehicle-transport/docs#vehicle-transport-bts-ontime-lookup Example request: ```json { "carrier": "DL", "origin": "ATL", "dest": "LGA", "year": 2026, "month": 8 } ``` Example response: ```json { "period": { "from": "2025-09", "to": "2026-08" }, "rows": [ { "key": { "year": 2026, "month": 8, "carrier": "DL", "origin": "ATL", "dest": "LGA" }, "scheduledFlights": 430, "cancelled": 16, "diverted": 3, "arrived": 411, "arrivedOnTime": 304 } ] } ```