{"uid":"cap_lG5fCCo8q36Aj0bIC_710","slug":"vindex-vehicle-purchase-cost-calculator-88d9ab33","name":"Vindex Vehicle Purchase Cost Calculator","description":"VIN decode, recalls, reliability, known issues, and drive-away costs across the US and Canada. Pay per call in USDC via x402 — no accounts, no API keys.","url":"https://api.vindexapi.dev/v1/purchase-costs","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country","price","sale_type"],"properties":{"price":{"type":"number","description":"Agreed sale price in the country's currency (> 0, ≤ 5,000,000)"},"state":{"type":"string","description":"US ONLY (required when country=US): two-letter state code, one of the 50 states or DC"},"country":{"enum":["CA","US"],"type":"string","description":"CA routes to Canadian per-jurisdiction rules, US to per-state rules"},"province":{"enum":["BC","AB","SK","MB","ON","QC","NB","NS","PE","NL","YT","NT","NU"],"type":"string","description":"CANADA ONLY (required when country=CA): two-letter province/territory code"},"trade_in":{"type":"number","description":"US ONLY — trade-in value in USD (≥ 0, < price); deducted from the tax base only for a dealer sale in a full-credit state"},"sale_type":{"enum":["private","dealer"],"type":"string","description":"Private sale or dealer sale"},"local_rate":{"type":"number","description":"US ONLY — exact county/city surtax percentage (0–15)"},"family_gift":{"type":"boolean","description":"CANADA ONLY, private sales only — applies the jurisdiction's family/related-individual gift exemption where one exists"},"buyer_has_plates":{"type":"boolean","description":"CANADA ONLY — selects plate-dependent fee lines where the jurisdiction distinguishes them"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"lines":[{"id":"rst","label":"Retail Sales Tax (13%)","amountCad":3250,"sourceUrl":"https://www.ontario.ca/","confidence":"high"}],"country":"CA","province":"ON","rulesAsOf":"2026-07-04","provinceName":"Ontario","totalKnownCad":3282}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MjXw0XDdqPhs5I2TOxELY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates itemized drive-away costs (taxes, fees) for a vehicle purchase in a given US state or Canadian province","exampleAgentPrompt":"What are the total taxes and fees I'd pay buying a $32,000 car from a dealer in Ontario, Canada — can you break down every line item?","exampleUseCases":[{"title":"Ontario dealer purchase cost breakdown","prompt":"I'm buying a $45,000 SUV from a dealer in Ontario — what are all the taxes and fees I'll owe at the time of purchase, broken down line by line?"},{"title":"Texas private sale with trade-in","prompt":"I'm doing a private sale in Texas for a car priced at $18,500, and I'm trading in my old car worth $4,000 — how much will I actually owe in taxes and fees?"},{"title":"BC family gift vehicle transfer","prompt":"My parents are gifting me their car in British Columbia — I already have plates. What purchase costs or taxes apply, and does the family gift exemption kick in for a private sale?"}],"resultDescription":"Returns an array of itemized cost lines (taxes, registration fees, etc.) each with an ID, human-readable label, amount in the jurisdiction's currency, a source URL, and a confidence rating. Also returns the country, province or state, total of all known costs, and the date the rules were last updated.","failureModes":["Missing required 'state' when country=US — returns validation error","Missing required 'province' when country=CA — returns validation error","Price out of range (<=0 or >5,000,000) — returns validation error","trade_in provided for Canadian transaction — ignored or rejected","local_rate out of 0–15 range — returns validation error","family_gift applied to a dealer sale — returns validation error or ignored","Unsupported province/territory code — returns validation error"],"whenToPreferThis":"Use this endpoint when you need a structured, per-jurisdiction breakdown of all taxes and fees that make up the drive-away cost of a vehicle purchase in the US or Canada. It is purpose-built for automotive transactions, covering both private and dealer sales, trade-in tax credits, family gift exemptions, and plate-dependent fee variations — making it more accurate than generic tax calculators for vehicle purchases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:38:14.202Z","isFirstParty":false}