{
  "name": "apis.vin",
  "description": "The estate API: every VIN-addressed capability behind one worker — decode and listings reads, the buy pillar’s deal lifecycle, the F&I pillar’s rating, menu, and contract verbs, and credit prequalification. Typed envelopes (OK / EMPTY / BLOCKED / OFFER) on every door; sandbox counterparties answer behind real wire shapes and every simulated payload says so.",
  "interfaces": {
    "http": [
      {
        "method": "GET",
        "url": "https://apis.vin/listings"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/pricing"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/openapi.json"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/llms.txt"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/family.json"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/offer"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/usage"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/suite.json"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/icp.json"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/keys"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/keys/me"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/webhooks"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/dealer/inventory"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/dealer/leads"
      },
      {
        "method": "GET",
        "url": "https://apis.vin/dealer/deals"
      }
    ],
    "mcp": {
      "url": "https://apis.vin/mcp",
      "transport": "streamable-http",
      "tools": [
        "search",
        "fetch",
        "exec"
      ]
    },
    "testSuite": {
      "url": "https://apis.vin/suite.json",
      "digest": "sha256:20183444abc2251eaa76773ad9e81f1c8ef439c4a7b6fc05719d58e58fab0c4c",
      "environment": "sandbox",
      "runner": "api.qa/vitest@1"
    }
  },
  "openapi": "https://apis.vin/openapi.json",
  "llms": "https://apis.vin/llms.txt",
  "links": {
    "openapi": "https://apis.vin/openapi.json",
    "llms": "https://apis.vin/llms.txt",
    "pricing": "https://apis.vin/pricing",
    "icp": "https://apis.vin/icp.json",
    "family": "https://apis.vin/family.json",
    "conformance": "https://api.qa/apis.vin"
  },
  "attestationLadder": [
    {
      "rung": "anonymous",
      "auth": "none",
      "grants": "every keyless read surface answers in full — the quartet, /listings, /decode/{vin}, the record face — and POST /keys mints a sandbox key with no email, no approval, no CAPTCHA"
    },
    {
      "rung": "sandbox-key",
      "auth": "Authorization: Bearer vk_sandbox_…",
      "obtain": "POST /keys — fully self-service; the key is returned exactly once and stored only as a sha256 hash",
      "grants": "account context (GET /keys/me) on top of every keyless surface; it never unlocks licensed or premium data tiers — the money gate is mandates and settlement, not registration"
    }
  ],
  "monetization": {
    "offers": [
      {
        "id": "listings-query",
        "title": "Listings query — GET /listings",
        "price": 0.01
      },
      {
        "id": "decode",
        "title": "VIN decode — GET /decode/{vin} and GET /vin/{vin} (anonymous rung)",
        "price": 0
      },
      {
        "id": "fi-quote",
        "title": "F&I rate quote — POST /fi/quotes",
        "price": 0.05
      },
      {
        "id": "refi-quote",
        "title": "Refinance quote — POST /financing/refinance/quotes",
        "price": 0.05
      },
      {
        "id": "build-read",
        "title": "Platform door (gateway-answered) — GET /build/{vin}",
        "price": 0.01
      },
      {
        "id": "recalls-read",
        "title": "Platform door (gateway-answered) — GET /recalls/{vin}",
        "price": 0.01
      },
      {
        "id": "openrecalls-read",
        "title": "Platform door (gateway-answered) — GET /openrecalls/{vin}",
        "price": 0.01
      },
      {
        "id": "payments-read",
        "title": "Platform door (gateway-answered) — GET /payments/{vin}",
        "price": 0.01
      },
      {
        "id": "apr-read",
        "title": "Platform door (gateway-answered) — GET /apr/{vin}",
        "price": 0.01
      },
      {
        "id": "tco-read",
        "title": "Platform door (gateway-answered) — GET /tco/{vin}",
        "price": 0.01
      },
      {
        "id": "taxes-read",
        "title": "Platform door (gateway-answered) — GET /taxes/{vin}",
        "price": 0.01
      },
      {
        "id": "plate-read",
        "title": "Platform door (gateway-answered) — GET /plate/{state}/{number}",
        "price": 0.01
      },
      {
        "id": "dealer-inventory",
        "title": "Dealer inventory read — GET /dealer/inventory",
        "price": 0.01
      }
    ],
    "probe": {
      "method": "GET",
      "url": "/offer"
    }
  },
  "probes": {
    "keyless": {
      "url": "/listings"
    },
    "knownEmpty": [
      {
        "url": "/listings?make=none"
      },
      {
        "url": "/listings?model=none"
      }
    ],
    "knownForbidden": [
      {
        "url": "/listings?scope=admin"
      },
      {
        "url": "/listings?scope=internal"
      }
    ],
    "pricing": {
      "url": "/pricing"
    },
    "overCeiling": {
      "url": "/listings",
      "param": "spend"
    }
  }
}