{"openapi":"3.1.0","info":{"title":"Vehicle VIN, Safety, Fuel Economy & On-Time API","version":"1.0.0","description":"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. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/vehicle-transport/vin-check-digit-validate":{"post":{"operationId":"validate_a_vin_check_digit","summary":"Validate a VIN check digit","description":"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.","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vin":{"type":"string","minLength":1,"maxLength":32}},"required":["vin"],"additionalProperties":false},"example":{"vin":"1HGCM82633A004352"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"vin":{"type":"string"},"valid":{"type":"boolean"},"length":{"type":"number"},"invalidCharacters":{"type":"array","items":{}},"checkDigit":{"type":"object","properties":{"expected":{"type":"string"},"actual":{"type":"string"},"matches":{"type":"boolean"}},"additionalProperties":true},"wmi":{"type":"string"},"vds":{"type":"string"},"vis":{"type":"string"},"modelYearCode":{"type":"string"},"modelYearCandidates":{"type":"array","items":{"type":"number"}}},"additionalProperties":true},"example":{"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]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/vehicle-transport/vin-decode":{"post":{"operationId":"decode_a_vin_via_vendored_vpic","summary":"Decode a VIN via vendored vPIC","description":"Decode a VIN to make, model, year, body, engine and plant fields from the vendored NHTSA vPIC standalone database. No live vPIC API call.","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vin":{"type":"string","minLength":3,"maxLength":17},"modelYear":{"type":"integer","minimum":1980,"maximum":2039},"includeAll":{"default":false,"type":"boolean"}},"required":["vin"],"additionalProperties":false},"example":{"vin":"4T1DBADK7SU506283"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"vin":{"type":"string"},"errorCodes":{"type":"array","items":{"type":"number"}},"errorText":{"type":"array","items":{"type":"string"}},"decoded":{"type":"object","properties":{"make":{"type":"string"},"manufacturerName":{"type":"string"},"model":{"type":"string"},"modelYear":{"type":"number"}},"additionalProperties":true},"snapshot":{"type":"string"}},"additionalProperties":true},"example":{"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"}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/vehicle-transport/nhtsa-recall-by-vin":{"post":{"operationId":"look_up_nhtsa_recalls_by_vin_or_make_model_year","summary":"Look up NHTSA recalls by VIN or make/model/year","description":"List NHTSA safety recall campaigns filed since 2010 for a VIN (decoded locally) or make/model/year from the vendored ODI flat file.","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vin":{"type":"string","minLength":17,"maxLength":17},"make":{"type":"string","minLength":1,"maxLength":80},"model":{"type":"string","minLength":1,"maxLength":80},"modelYear":{"type":"integer","minimum":1900,"maximum":2039},"recallType":{"type":"array","items":{"type":"string","enum":["V","E","T","C"]}},"limit":{"default":50,"type":"integer","minimum":1,"maximum":200},"includeUnknownYear":{"default":false,"type":"boolean"}},"additionalProperties":false},"example":{"vin":"1HGCM82633A004352"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"modelYear":{"type":"number"},"fromVin":{"type":"boolean"}},"additionalProperties":true},"count":{"type":"number"},"recalls":{"type":"array","items":{"type":"object","properties":{"campaignNumber":{"type":"string"},"recallType":{"type":"string"},"potentiallyAffected":{"type":"number"}},"additionalProperties":true}},"snapshotDate":{"type":"string"}},"additionalProperties":true},"example":{"query":{"make":"HONDA","model":"ACCORD","modelYear":2003,"fromVin":true},"count":12,"recalls":[{"campaignNumber":"15V320000","recallType":"vehicle","potentiallyAffected":6281043}],"snapshotDate":"2026-11-14"}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/vehicle-transport/nhtsa-safety-ratings":{"post":{"operationId":"look_up_nhtsa_5_star_safety_ratings","summary":"Look up NHTSA 5-Star Safety Ratings","description":"Return NHTSA Safercar 5-Star Safety Ratings and listed safety equipment for a make, model and model year from the vendored Safercar file.","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"make":{"type":"string","minLength":1,"maxLength":80},"model":{"type":"string","minLength":1,"maxLength":80},"modelYear":{"type":"integer","minimum":1990,"maximum":2027},"driveTrain":{"type":"string","minLength":1,"maxLength":40},"bodyStyle":{"type":"string","minLength":1,"maxLength":40},"vin":{"type":"string","minLength":17,"maxLength":17}},"additionalProperties":false},"example":{"make":"TOYOTA","model":"CAMRY HYBRID","modelYear":2025}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"variants":{"type":"array","items":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"modelYear":{"type":"number"},"overallStars":{"type":"number"},"driveTrain":{"type":"string"}},"additionalProperties":true}},"snapshotDate":{"type":"string"}},"additionalProperties":true},"example":{"count":2,"variants":[{"make":"TOYOTA","model":"CAMRY HYBRID","modelYear":2025,"overallStars":5,"driveTrain":"AWD"}],"snapshotDate":"2026-11-14"}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/vehicle-transport/epa-fuel-economy-lookup":{"post":{"operationId":"look_up_epa_fuel_economy","summary":"Look up EPA fuel economy","description":"Return EPA fuel-economy, CO2 and annual fuel-cost figures (and EV range/consumption) from the vendored fueleconomy.gov vehicle file.","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"year":{"type":"integer","minimum":1984,"maximum":2027},"make":{"type":"string","minLength":1,"maxLength":80},"model":{"type":"string","minLength":1,"maxLength":80},"baseModel":{"type":"string","minLength":1,"maxLength":80},"drive":{"type":"string","minLength":1,"maxLength":80},"limit":{"default":25,"type":"integer","minimum":1,"maximum":100}},"required":["year","make"],"additionalProperties":false},"example":{"year":2025,"make":"Toyota","baseModel":"Camry"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"vehicles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"year":{"type":"number"},"make":{"type":"string"},"model":{"type":"string"},"mpg":{"type":"object","properties":{"city":{"type":"number"},"highway":{"type":"number"},"combined":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}},"snapshotDate":{"type":"string"}},"additionalProperties":true},"example":{"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"}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/vehicle-transport/uk-ved-rate-lookup":{"post":{"operationId":"look_up_uk_vehicle_excise_duty","summary":"Look up UK Vehicle Excise Duty","description":"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.","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"category":{"type":"string","enum":["car","light-goods","motorcycle","tricycle","private-heavy-goods"]},"firstRegistered":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"taxDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"payment":{"type":"string","enum":["first-registration","renewal"]},"fuel":{"type":"string","enum":["petrol","diesel","alternative","electric"]},"co2GPerKm":{"type":"integer","minimum":0,"maximum":9007199254740991},"dieselMeetsRde2":{"type":"boolean"},"listPricePence":{"type":"integer","minimum":0,"maximum":9007199254740991},"engineCc":{"type":"integer","minimum":0,"maximum":9007199254740991},"euroStandard":{"type":"string","enum":["euro4","euro5"]}},"required":["category","firstRegistered","payment"],"additionalProperties":false},"example":{"category":"car","firstRegistered":"2025-05-01","payment":"renewal","fuel":"petrol","co2GPerKm":120,"listPricePence":4500000,"taxDate":"2026-05-01"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"rule":{"type":"string"},"ratesPence":{"type":"object","properties":{"twelveMonths":{"type":"number"},"twelveMonthsDirectDebit":{"type":"number"},"twelveMonthlyDirectDebitTotal":{"type":"number"},"sixMonths":{"type":"number"},"sixMonthsDirectDebit":{"type":"number"}},"additionalProperties":true},"expensiveCarSupplementApplied":{"type":"boolean"}},"additionalProperties":true},"example":{"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}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/vehicle-transport/bts-ontime-lookup":{"post":{"operationId":"look_up_bts_airline_on_time_performance","summary":"Look up BTS airline on-time performance","description":"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).","tags":["vehicle-transport"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"carrier":{"type":"string","pattern":"^[A-Z0-9]{2}$"},"origin":{"type":"string","pattern":"^[A-Z]{3}$"},"dest":{"type":"string","pattern":"^[A-Z]{3}$"},"year":{"type":"integer","minimum":2025,"maximum":2026},"month":{"type":"integer","minimum":1,"maximum":12},"groupBy":{"type":"array","items":{"type":"string","enum":["month","carrier","route"]}}},"additionalProperties":false},"example":{"carrier":"DL","origin":"ATL","dest":"LGA","year":2026,"month":8}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"additionalProperties":true},"rows":{"type":"array","items":{"type":"object","properties":{"key":{"type":"object","properties":{"year":{"type":"number"},"month":{"type":"number"},"carrier":{"type":"string"},"origin":{"type":"string"},"dest":{"type":"string"}},"additionalProperties":true},"scheduledFlights":{"type":"number"},"cancelled":{"type":"number"},"diverted":{"type":"number"},"arrived":{"type":"number"},"arrivedOnTime":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true},"example":{"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}]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}