{
  "name": "vindex",
  "description": "Vehicle Intelligence for AI agents — Canada-aware, per-call, no signup. Pay per call with x402 (USDC on Base or Solana) to decode any 17-char VIN, read MERGED US (NHTSA) + Canada (Transport Canada) recalls, and get reliability stats, LLM-clustered known-issue reports (every issue cites verified ODI complaint numbers), and itemized used-car closing costs for all of Canada (10 provinces + 3 territories) + all 50 US states & DC. FREE /v1/sample/* endpoints return every response shape for one fixed sample vehicle (2013 Ford F-150). Informational only — not a vehicle-history report.",
  "url": "https://api.vindexapi.dev",
  "provider": {
    "organization": "Vindex",
    "url": "https://api.vindexapi.dev",
    "contact": { "email": "jcislo918@gmail.com" }
  },
  "version": "0.1.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "endpoints": [
    { "method": "GET", "path": "/health", "params": [], "priceUsd": 0, "description": "Liveness + configured payment mode." },
    { "method": "GET", "path": "/v1/sample/decode", "params": [], "priceUsd": 0, "description": "FREE sample VIN decode (fixed 2013 Ford F-150; same shape as paid /v1/decode)." },
    { "method": "GET", "path": "/v1/sample/recalls", "params": [], "priceUsd": 0, "description": "FREE sample merged US (NHTSA) + Canada recalls (same shape as paid /v1/recalls)." },
    { "method": "GET", "path": "/v1/sample/reliability", "params": [], "priceUsd": 0, "description": "FREE sample reliability stats (same shape as paid /v1/reliability)." },
    { "method": "GET", "path": "/v1/sample/known-issues", "params": [], "priceUsd": 0, "description": "FREE sample known-issues (same shape as paid /v1/known-issues; served as-is, never 503)." },
    { "method": "GET", "path": "/v1/sample/purchase-costs", "params": [], "priceUsd": 0, "description": "FREE sample Ontario closing costs (fixed ON / $25,000 / private sale)." },
    { "method": "GET", "path": "/v1/decode", "params": ["vin"], "priceUsd": 0.01, "description": "NHTSA vPIC normalized VIN decode. Per-call x402." },
    { "method": "GET", "path": "/v1/recalls", "params": ["vin"], "priceUsd": 0.01, "description": "Merged US (NHTSA) + Canada (Transport Canada) recalls. Per-call x402." },
    { "method": "GET", "path": "/v1/reliability", "params": ["vin"], "priceUsd": 0.05, "description": "Complaint stats + US/Canada recall counts incl. Canadian units affected." },
    { "method": "GET", "path": "/v1/known-issues", "params": ["vin"], "priceUsd": 0.25, "description": "LLM-clustered failure modes with verified ODI-complaint citations; refuses (uncharged) below 15 complaints." },
    { "method": "GET", "path": "/v1/ca/purchase-costs", "params": ["province", "price", "sale_type", "buyer_has_plates", "family_gift"], "priceUsd": 0.02, "description": "Itemized Canadian used-vehicle closing costs for any of the 10 provinces + 3 territories (BC/AB/SK/MB/ON/QC/NB/NS/PE/NL/YT/NT/NU): provincial tax (PST/RST/QST/HST or GST-only) + transfer/registration/plate fees + inspection." },
    { "method": "GET", "path": "/v1/us/purchase-costs", "params": ["state", "price", "sale_type", "trade_in", "local_rate"], "priceUsd": 0.02, "description": "Itemized US used-vehicle closing costs for any of the 50 states + DC (tax, title, first-year registration, inspection, dealer doc fee)." }
  ],
  "x402": {
    "version": 2,
    "networks": ["eip155:8453", "solana"],
    "assets": ["USDC"]
  },
  "skills": [
    {
      "id": "vin-decode-recalls",
      "name": "VIN decode + merged US/Canada recalls",
      "description": "Decode a 17-character VIN via NHTSA vPIC and pull the merged US (NHTSA) + Canada (Transport Canada) recall set — the only API combining both, with Open Government Licence – Canada attribution. Per-call x402 ($0.01 each); try the exact shapes free at /v1/sample/decode and /v1/sample/recalls.",
      "tags": ["vin", "vehicle", "recalls", "nhtsa", "transport-canada", "canada"],
      "examples": [
        "Decode VIN 1FA6P8TH5J5100000 and tell me the make, model, and year.",
        "List every open US and Canadian recall for this VIN, including Canadian units affected."
      ]
    },
    {
      "id": "reliability-known-issues",
      "name": "Reliability stats + LLM-clustered known issues",
      "description": "Per-call x402 intelligence: reliability stats (top complaint components, crash/fire/injury severity signals, US+Canada recall counts) for $0.05, and LLM-clustered named failure modes where every issue cites verified NHTSA ODI complaint numbers (hallucination-gated; refuses uncharged below 15 complaints) for $0.25. USDC on Base or Solana.",
      "tags": ["reliability", "complaints", "known-issues", "x402", "nhtsa", "odi"],
      "examples": [
        "What are the top recurring failure modes for this VIN, with complaint citations?",
        "Give me the reliability snapshot (complaint components + severity + recall counts) for this VIN."
      ]
    },
    {
      "id": "purchase-costs",
      "name": "Used-vehicle purchase costs (all Canada + all 50 US states & DC)",
      "description": "Itemized government-imposed closing costs of buying a used passenger vehicle, each line with a per-line source URL and confidence. Canada (/v1/ca/purchase-costs): all 10 provinces + 3 territories (BC/AB/SK/MB/ON/QC/NB/NS/PE/NL/YT/NT/NU) — provincial/territorial sales tax (PST/RST/QST/HST or GST-only, flat-on-whole bracket tax like BC's 12/15/20%; AB + YT/NT/NU have no private-sale tax) plus transfer/registration/plate fees and inspection, with family-gift and plate-dependent fee handling. Any US state or DC (/v1/us/purchase-costs): sales/use/excise tax, title, first-year registration, inspection, and dealer doc fee — with special regimes handled (DC tiered excise, IL flat private-party table, SC $500 IMF cap, and private-sale-exempt states). $0.02 per call via x402.",
      "tags": ["ontario", "canada", "provinces", "territories", "us", "states", "purchase-costs", "tax", "pst", "rst", "qst", "hst", "gst", "sales-tax", "x402"],
      "examples": [
        "What will it cost me to close a $25,000 private used-car purchase in Ontario?",
        "How much PST on a $60,000 private used-car sale in British Columbia?",
        "Compute California closing costs for a $25,000 private sale.",
        "What are the total fees for a $30,000 dealer sale in Texas with a $5,000 trade-in?"
      ]
    }
  ],
  "authentication": {
    "schemes": ["none", "x402"],
    "description": "Free endpoints (/health, /v1/sample/*, /terms.*) need no auth — the /v1/sample/* set returns every response shape for one fixed sample vehicle. Paid endpoints (/v1/decode, /v1/recalls, /v1/reliability, /v1/known-issues, /v1/ca/purchase-costs, /v1/us/purchase-costs) use the x402 V2 HTTP-402 flow: on an unpaid request the server returns a 402 whose accepts[] lists an 'exact' USDC rail for Base (eip155:8453) and Solana. Sign one rail and retry with the PAYMENT-SIGNATURE header (x402 V2) or legacy X-PAYMENT header. Per-call pricing; compute-first / settle-after (never charged for errors or below-threshold answers)."
  },
  "documentationUrl": "https://api.vindexapi.dev/llms.txt",
  "openApiUrl": "https://api.vindexapi.dev/openapi.json",
  "termsOfService": "https://api.vindexapi.dev/terms.txt"
}