llms.txt
Compare with other sites' llms.txt files →# Cardog
> The system of record for the Canadian vehicle. A typed graph of automotive
> entities (every make, model, model year, recall and safety rating) under a
> permanent `{domain}:{key}` ref, served as a REST API with an error
> contract built for agents: an unknown ref is a 400 that names it and
> suggests the nearest match. There is no fuzzy matching and no empty result for a bad ref.
The ref grammar is open source and free to hold: `npm install @cardog/entities`
validates, builds and types refs offline with no API call and no key.
## Docs
- [Full documentation](https://cardog.app/docs.md): every guide and the complete API reference as one markdown document. One fetch answers most questions.
- [Changelog](https://cardog.app/changelog.md): what shipped, newest first, as one markdown document.
- [Quickstart](https://cardog.app/docs/quickstart.md): Your first API call in three steps.
- [Authentication](https://cardog.app/docs/authentication.md): API keys, the two accepted headers, and plan limits.
- [The Vehicle Graph](https://cardog.app/docs/vehicle-graph.md): The data model behind every endpoint: typed entities, permanent refs, and the grains that connect a VIN to specs, recalls, and the live market.
- [Entity resolution](https://cardog.app/docs/entity-resolution.md): How text, a VIN, or a build code becomes one entity, and how to read a shortlist.
- [Conventions](https://cardog.app/docs/conventions.md): Encoding, response shape, null semantics, and the stability contract.
- [Credits](https://cardog.app/docs/credits.md): Rates, plan allowances, budget headers, and the free-tier stop.
- [Errors](https://cardog.app/docs/errors.md): The v2 error envelope and a correction recipe for every well-known code.
- [Versioning](https://cardog.app/docs/versioning.md): A request names the contract version it was built against in the Cardog-Version header and gets that version's shape for 12 months after the next one lands.
- [Units](https://cardog.app/docs/units.md): Every measure is a { value, unitCode } pair using UN/CEFACT Recommendation 20 codes.
- [Report a wrong or missing record](https://cardog.app/docs/feedback.md): Tell us a VIN decoded wrong or not at all, get a receipt, and read back what happened. Free.
- [Decode a Canadian VIN](https://cardog.app/docs/decode-canadian-vin.md): One VIN in, refs, grains, and links out, for 99.77% of Canadian VINs.
- [VIN structure](https://cardog.app/docs/vin.md): What each of the 17 characters means, how to check one, and how Cardog keys on it.
- [Chinese VINs](https://cardog.app/docs/chinese-vins.md): BYD, Zeekr, XPeng, Chery, Haval and more, decoded to model and year.
- [Window stickers by VIN](https://cardog.app/docs/window-sticker.md): The factory window sticker (Monroney label) we hold for a VIN, or a typed reason there is none. Free when there is none.
- [Japanese chassis numbers](https://cardog.app/docs/chassis.md): A Japanese home-market vehicle carries a chassis number, not a VIN. Read it to its maker, models, type approvals and build dates, or read the number off a photo of the plate.
- [Parts](https://cardog.app/docs/parts.md): OEM part numbers for a model year or a build, with the recalls that name them and the manufacturer's own parts store.
- [From a carrier's name to its fleet](https://cardog.app/docs/carriers.md): Find a motor carrier by name, DOT number or VIN; read what it declared and what the road record shows; walk every unit observed under it, and from any unit back to its carriers.
- [Feeds](https://cardog.app/docs/feeds.md): An organization's own vehicle identity rows, rebuilt every night and handed over as files: a full file, a delta file and a deletes file, each with its record count and SHA-256.
- [Market data](https://cardog.app/docs/market-data.md): Instruments, quotes, and the tape.
- [Recalls by VIN](https://cardog.app/docs/recalls.md): Recall campaigns listed for a VIN's model year in its market of sale (Transport Canada and ECCC by default, every authority its own record), plus entity sweeps for fleets.
- [Safety ratings](https://cardog.app/docs/safety.md): NHTSA crash ratings matched to the exact build, with equipment and the regulator's original text.
- [Locations](https://cardog.app/docs/locations.md): Places a driver goes: fuel stations, chargers and dealers, one ref each, searched by distance and joined to fuel prices and chargers.
- [Fuel prices](https://cardog.app/docs/fuel.md): Fuel stations near a point with their pump prices, and the daily price for Canada, a province or a postal area.
- [Charging stations](https://cardog.app/docs/charging.md): Radius search and station detail over Open Charge Map data, served from our own database.
- [Build with locations](https://cardog.app/docs/build-with-locations.md): Five things to build on locations, fuel prices and chargers: cost to drive, cheapest fuel on a route, EV against gas by postal area, what is around a dealer, and a fleet fuel budget.
- [SDKs](https://cardog.app/docs/sdks.md): The TypeScript and Python clients, generated from the same contract the API validates against.
- [Ref grammar](https://cardog.app/docs/ref-grammar.md): Validate, build, and type refs offline with @cardog/entities.
- [For agents](https://cardog.app/docs/agents.md): One-fetch docs, errors that carry the fix, resolve first, and machine-readable pricing.
- [MCP server](https://cardog.app/docs/mcp.md): Connect Claude, Cursor, VS Code, and any MCP client to Cardog vehicle data.
## API reference
- [VIN](https://cardog.app/docs/reference/vin.md): Identity: VIN → refs, grains, links
- [Chassis](https://cardog.app/docs/reference/chassis.md): Japanese chassis numbers: the number to its maker, models, type approvals and build dates, and the number off a plate photo
- [Entities](https://cardog.app/docs/reference/entities.md): The registry: browse, resolve, dereference
- [Specs](https://cardog.app/docs/reference/specs.md): The attribute catalog + canonical spec sheets
- [Listings](https://cardog.app/docs/reference/listings.md): Ref-native listing search, counts, facets
- [Instruments](https://cardog.app/docs/reference/instruments.md): Market symbology + instrument cards
- [Quotes](https://cardog.app/docs/reference/quotes.md): The live book per instrument
- [Tape](https://cardog.app/docs/reference/tape.md): Prints + daily bars
- [Recalls](https://cardog.app/docs/reference/recalls.md): Transport Canada and NHTSA campaigns by model year, ref-keyed
- [History](https://cardog.app/docs/reference/history.md): What happened to a unit, one kind of event per route, every item with its source
- [Carriers](https://cardog.app/docs/reference/carriers.md): The motor carrier register: name → DOT number → fleet
- [Safety](https://cardog.app/docs/reference/safety.md): NCAP ratings + complaints
- [Charging](https://cardog.app/docs/reference/charging.md): EV charging stations (Open Charge Map data, ODbL)
- [Parts](https://cardog.app/docs/reference/parts.md): OEM part numbers by model year, linked to the manufacturer's official parts store
- [Fuel](https://cardog.app/docs/reference/fuel.md): Fuel stations and pump prices in Canada
- [Locations](https://cardog.app/docs/reference/locations.md): Places a driver goes: fuel stations, chargers and dealers, one ref each
- [Platform](https://cardog.app/docs/reference/platform.md): Pricing, spec, meta
## Machine-readable
- [OpenAPI 3.1 spec](https://api.cardog.app/v2/openapi.json): the contract every response is validated against.
- [Rate card](https://api.cardog.app/v2/pricing): plans, per-family credit rates and packs as JSON, no auth required.
- [Agent Skill](https://cardog.app/skill.md): the same platform as a decision tree, installable in any skills-compatible harness (`npx skills add cardog.app`). Indexed at `/.well-known/agent-skills/index.json`.
Every HTML docs page has a markdown twin: append `.md`, or send
`Accept: text/markdown`.
## Resources
- [Resources](https://cardog.app/resources.md): every guide below, one index.
- [How to migrate from Auto.dev to Cardog](https://cardog.app/resources/migration/auto-dev.md): Move from Auto.dev's VIN decode to Cardog's /v2/vin, with a field-by-field map and an adapter you can use while you switch.
- [How to migrate from CarsXE to Cardog](https://cardog.app/resources/migration/carsxe.md): Replace CarsXE's /specs call with two Cardog calls, and use a small adapter you own to keep CarsXE-shaped code working while you compare results.
- [How to migrate from MarketCheck to Cardog](https://cardog.app/resources/migration/marketcheck.md): Move your MarketCheck inventory search to Cardog listings: the field map, ref and spec filters, and an adapter you run in your own code.
- [How to migrate from NHTSA vPIC to Cardog](https://cardog.app/resources/migration/nhtsa-vpic.md): Move a vPIC DecodeVinValues call to Cardog by changing the URL: add ?profile=vpic and an API key, and keep the response shape your code already reads.
- [How to migrate from VinAudit to Cardog](https://cardog.app/resources/migration/vinaudit.md): Swap VinAudit's specifications call for Cardog's VIN and spec sheet calls, with a field map and an adapter.
- [Cardog vs Auto.dev](https://cardog.app/resources/compare/auto-dev.md): Cardog next to Auto.dev: coverage, recalls, listings, pricing, auth, batch decode, SDKs and agents, with every Auto.dev claim linked to Auto.dev's own page.
- [Cardog vs Canadian Black Book](https://cardog.app/resources/compare/canadian-black-book-data.md): Cardog next to Canadian Black Book data and APIs: market data, values, VIN decode, recalls, formats, pricing and access, with every Canadian Black Book claim linked.
- [Cardog vs CarsXE](https://cardog.app/resources/compare/carsxe.md): Cardog next to CarsXE: coverage, recalls, specs, pricing, auth and versioning, with every CarsXE claim linked to CarsXE's own page.
- [Cardog vs DataOne Software](https://cardog.app/resources/compare/dataone.md): Cardog next to DataOne Software: Canadian coverage, VIN decode, specifications, recalls, delivery, pricing and access, with every DataOne claim linked to its own page.
- [Cardog vs MarketCheck](https://cardog.app/resources/compare/marketcheck.md): Cardog next to MarketCheck: listings, filters, recalls, decode, pricing, auth and agents, with every MarketCheck claim linked to MarketCheck's own page.
- [Cardog vs NHTSA vPIC](https://cardog.app/resources/compare/nhtsa-vpic.md): Cardog next to NHTSA vPIC: coverage, recalls, join keys, pricing, auth, batch size, SDKs and agents, with every vPIC claim linked to NHTSA's own page.
- [Cardog vs VinAudit](https://cardog.app/resources/compare/vinaudit.md): Cardog next to VinAudit: coverage, recalls, specs, units, pricing, auth and batch decode, with every VinAudit claim linked to VinAudit's own page.
- [Auto.dev alternatives](https://cardog.app/resources/alternatives/auto-dev.md): Alternatives to Auto.dev for vehicle data, led by Cardog, with what each covers, Canadian coverage, published pricing and free tiers, linked to each vendor's own pages.
- [AutoTrader.ca alternatives](https://cardog.app/resources/alternatives/autotrader-ca.md): Alternatives to AutoTrader.ca for shopping and pricing cars in Canada, led by Cardog, with CarGurus and Kijiji, each described from its own public pages.
- [Canada Drives alternatives](https://cardog.app/resources/alternatives/canada-drives.md): Alternatives to Canada Drives for buying a used car in Canada, led by Cardog's free listings, VIN pages and market prices, with Clutch and AutoTrader.ca from their own pages.
- [Canadian Black Book alternatives](https://cardog.app/resources/alternatives/canadian-black-book.md): Alternatives to Canadian Black Book's consumer car value tool, led by Cardog's free market quote, with AutoTrader.ca and CarGurus valuations, from each one's own pages.
- [Carfax API alternatives](https://cardog.app/resources/alternatives/carfax-api.md): Looking for a Carfax API for Canadian vehicles? What Carfax Canada publishes for developers, and self-serve vehicle data APIs with Canadian coverage, led by Cardog.
- [Carfax Canada alternatives](https://cardog.app/resources/alternatives/carfax-canada.md): Alternatives to a Carfax Canada report for Canadian used-car buyers: Cardog's free VIN decode, recalls and price, then provincial history records, lien registries and UCDA searches.
- [CarGurus Canada alternatives](https://cardog.app/resources/alternatives/cargurus-canada.md): Alternatives to CarGurus Canada for finding and pricing used cars, led by Cardog, with AutoTrader.ca and Kijiji, each described from its own public pages.
- [CarsXE alternatives](https://cardog.app/resources/alternatives/carsxe.md): Alternatives to CarsXE for vehicle data, led by Cardog, with what each covers, Canadian coverage, published pricing and free tiers, linked to each vendor's own pages.
- [Clutch alternatives](https://cardog.app/resources/alternatives/clutch.md): Alternatives to Clutch for buying a used car in Canada, led by Cardog's free listings, VIN pages and market prices, with Canada Drives and AutoTrader.ca from their own pages.
- [DataOne Software alternatives](https://cardog.app/resources/alternatives/dataone.md): Alternatives to DataOne Software for VIN decoding and vehicle data in Canada, led by Cardog, with coverage and pricing linked to each vendor's own pages.
- [Facebook Marketplace cars alternatives](https://cardog.app/resources/alternatives/facebook-marketplace-cars.md): Alternatives to Facebook Marketplace for buying a used car in Canada, led by Cardog's free listings, VIN pages and market prices, with Kijiji and AutoTrader.ca from their own pages.
- [J.D. Power ChromeData alternatives](https://cardog.app/resources/alternatives/jd-power-chromedata.md): Alternatives to J.D. Power ChromeData for VIN descriptions and vehicle specification data, led by Cardog, with every vendor claim linked to its own page.
- [Kijiji Autos alternatives](https://cardog.app/resources/alternatives/kijiji-autos.md): Alternatives to Kijiji Autos for buying a used car in Canada, led by Cardog, with AutoTrader.ca and CarGurus, each described from its own public pages.
- [MarketCheck alternatives](https://cardog.app/resources/alternatives/marketcheck.md): Alternatives to MarketCheck for listings and market data, led by Cardog, with what each covers, Canadian coverage, published pricing and free tiers, linked to each vendor's pages.
- [Mobility Global VINtelligence alternatives](https://cardog.app/resources/alternatives/sp-global-mobility.md): Alternatives to VINtelligence, the VIN decoder from Mobility Global (formerly S&P Global Mobility, home of Polk), led by Cardog, with every vendor claim linked.
- [NHTSA vPIC alternatives](https://cardog.app/resources/alternatives/nhtsa-vpic.md): Alternatives to NHTSA vPIC for VIN decoding, led by Cardog, with what each covers, Canadian coverage, published pricing and free tiers, linked to each vendor's own pages.
- [VinAudit alternatives](https://cardog.app/resources/alternatives/vinaudit.md): Alternatives to VinAudit for VIN decoding and vehicle data, led by Cardog, with what each covers, Canadian coverage, published pricing and free tiers, linked to each vendor's pages.
- [Best free VIN check in Canada (2026)](https://cardog.app/resources/library/best-free-vin-check-canada.md): The free VIN checks a Canadian used-car buyer can run in 2026: Cardog's VIN decode, recalls and market price, manufacturer recall lookups, the CPIC stolen search and SGI's Saskatchewan VIN search.
- [Best recall check tools in Canada (2026)](https://cardog.app/resources/library/best-recall-check-tools-canada.md): Where Canadian drivers and used-car buyers can check vehicle recalls for free in 2026: Cardog, Transport Canada's database and manufacturers' VIN lookups, from their own pages.
- [Best recall data sources for Canada (2026)](https://cardog.app/resources/library/best-recall-data-sources-canada.md): Where to get vehicle recall data for Canada: Cardog, Transport Canada, manufacturers' VIN lookups, NHTSA and four more APIs, compared on authority, access and price.
- [Best used car price tools in Canada (2026)](https://cardog.app/resources/library/best-used-car-price-tools-canada.md): Used car price tools for Canadian buyers and sellers in 2026: Cardog's free market quote, AutoTrader.ca, CarGurus, Kijiji and Canadian Black Book, from each one's own pages.
- [Best vehicle market-data APIs (2026)](https://cardog.app/resources/library/best-vehicle-market-data-apis.md): Seven vehicle market-data APIs compared on Canadian coverage, listings, price data, published pricing, free tiers and access, with every vendor claim linked.
- [Best vehicle specification data providers (2026)](https://cardog.app/resources/library/best-vehicle-specification-data-providers.md): Seven vehicle specification data providers compared on Canadian coverage, data depth, delivery, published pricing and access, with every vendor claim linked.
- [Best vehicle valuation data for Canada (2026)](https://cardog.app/resources/library/best-vehicle-valuation-data-canada.md): Five vehicle valuation and market price data APIs for Canada compared on what they return, Canadian currency and units, published pricing and access, with every claim linked.
- [Best VIN decoder APIs (2026)](https://cardog.app/resources/library/best-vin-decoder-apis.md): Ten VIN decoder APIs and data providers compared on Canadian coverage, data depth, published pricing, free tiers, auth, batch and agent support, with every vendor claim linked.
- [A fuel price API for Canada](https://cardog.app/resources/learn/canadian-fuel-price-api.md): Cardog's fuel API: stations near a point with their pump prices in Canadian cents per litre, and the daily price for Canada, a province or a postal area.
- [Buying a used car in Alberta](https://cardog.app/resources/learn/buying-a-used-car-in-alberta.md): What Alberta requires when you buy a used car: AMVIC licensing and all-in pricing, no cooling-off period, the private-sale steps the province lists, and free VIN and price checks.
- [Buying a used car in British Columbia](https://cardog.app/resources/learn/buying-a-used-car-in-british-columbia.md): What BC requires when you buy a used car: VSA dealer licensing and disclosure, the ICBC transfer and 10-day registration, and the free checks to run on the VIN first.
- [Buying a used car in Quebec](https://cardog.app/resources/learn/buying-a-used-car-in-quebec.md): What Quebec requires when you buy a used car: the merchant's OPC licence, the label and the A to D warranty classes, the SAAQclic transfer, and free VIN and price checks.
- [Canadian vs US recalls: Transport Canada and NHTSA](https://cardog.app/resources/learn/canadian-vs-us-recalls.md): Why one defect can be two recalls, how Transport Canada and NHTSA campaigns differ, and how to check whether a specific vehicle is affected.
- [Do you need a Carfax report?](https://cardog.app/resources/learn/do-you-need-a-carfax-report.md): When a used-car buyer in Canada needs a vehicle history report, and the free checks to run first: the VIN decode, recalls, the CPIC stolen search and the market price.
- [How to check a used car's history in Canada](https://cardog.app/resources/learn/how-to-check-a-used-cars-history-in-canada.md): Where a Canadian used-car buyer gets the accident, lien and ownership record, province by province: Ontario, BC, Alberta, Saskatchewan, Manitoba and Quebec, plus national reports.
- [How to check a VIN for free in Canada](https://cardog.app/resources/learn/how-to-check-a-vin-for-free-in-canada.md): Check a VIN for free in Canada in four steps: find it, decode it on Cardog, read its recalls and confirm with the maker, then search the CPIC stolen vehicle database.
- [How to check recalls on a used car in Canada](https://cardog.app/resources/learn/how-to-check-recalls-on-a-used-car-canada.md): Check a used car's recalls in Canada for free: paste the VIN into Cardog for the recalls Transport Canada lists, then confi