Platform

live

Pricing, spec, meta

GET/v2/pricingno auth

The machine-readable rate card

Credit rates per family + plan allowances, as JSON. Budget mid-task with this plus the X-Credits-* headers on every metered response. Unauthenticated.

curl "https://api.cardog.app/v2/pricing"

Response 200 — Pricing

FieldType

Example response

11 keys
"response": {
"version": 5,
"asOf": "2026-07-27T00:00:00.000Z",
"currency": "USD",
"rates": [
0: {4 items},
1: {4 items},
2: {4 items},
3: {4 items},
4: {4 items},
5: {4 items},
6: {4 items},
7: {4 items},
8: {4 items},
9: {4 items}
],
"plans": [
0: {8 items},
1: {8 items},
2: {8 items},
3: {8 items},
4: {7 items}
],
"packs": [
0: {4 items},
1: {4 items},
2: {4 items}
],
"customTopUp": {
"ratePerCredit": 0.04,
"minCredits": 125,
"maxCredits": 50000,
"expiryMonths": 12
},
"creditHeaders": [
0: "X-Credits-Rate",
1: "X-Credits-Remaining",
2: "X-Credits-Allowance",
3: "X-Credits-Reset",
4: "X-Credits-Source"
],
"signupGrant": {
"credits": 1000,
"endsAt": "2026-08-03T00:00:00.000Z",
"expiryMonths": 12,
"description": "Launch week — 1,000 credits, a free month of Starter."
},
"links": {
"openapi": "/v2/openapi.json"
},
"docs_url": "https://cardog.app/docs"
}

Errors — every non-2xx body is the error envelope: 429, 500

GET/v2/openapi.jsonno auth

This document

curl "https://api.cardog.app/v2/openapi.json"

Example response

7 keys
"response": {
"openapi": "3.0.3",
"info": {
"title": "Cardog API v2",
"version": "2.0.0-rc.1",
"description": "VIN identity, canonical specs, live market data, and recalls — one key. **The ref is the API.** Every parameter is an entity ref (`make:tesla`, `model-year:honda/cr-v/2026`) or a VIN; every response carries refs plus `links` to adjacent resources. Free text is accepted in exactly one place — `GET /v2/entities/resolve` — and returns refs with confidence, never silently fuzzed results. **Errors are instructions.** Every non-2xx body is the ErrorEnvelope: `code`, `message`, `hint`, `docs_url`, the offending `refs` named, and nearest-ref `suggestions` where computable. **Price is machine-readable.** `GET /v2/pricing` is the live rate card; every metered response carries `X-Credits-*` headers.",
"contact": {3 items}
},
"servers": [
0: {1 item}
],
"tags": [
0: {2 items},
1: {2 items},
2: {2 items},
3: {2 items},
4: {2 items},
5: {2 items},
6: {2 items},
7: {2 items},
8: {2 items},
9: {2 items}
],
"paths": {
"/v2/vin/{vin}": {1 item},
"/v2/vin/batch": {1 item},
"/v2/vin/{vin}/instrument": {1 item},
"/v2/vin/{vin}/recalls": {1 item},
"/v2/vin/{vin}/listings": {1 item},
"/v2/entities": {1 item},
"/v2/entities/resolve": {1 item},
"/v2/entities/{ref}": {1 item},
"/v2/specs/catalog": {1 item},
"/v2/specs/{ref}": {1 item},
"/v2/listings/search": {1 item},
"/v2/listings/count": {1 item},
"/v2/listings/facets": {1 item},
"/v2/listings/id/{id}": {1 item},
"/v2/listings/vin/{vin}": {1 item},
"/v2/instruments": {1 item},
"/v2/instruments/{ref}": {1 item},
"/v2/quotes": {1 item},
"/v2/quotes/{ref}": {1 item},
"/v2/tape/live": {1 item},
"/v2/tape/history/{ref}": {1 item},
"/v2/recalls/vin/{vin}": {1 item},
"/v2/recalls/entity/{ref}": {1 item},
"/v2/recalls/feed": {1 item},
"/v2/recalls/stats": {1 item},
"/v2/recalls/{ref}": {1 item},
"/v2/safety/{ref}": {1 item},
"/v2/safety/{ref}/complaints": {1 item},
"/v2/pricing": {1 item},
"/v2/openapi.json": {1 item}
},
"components": {
"securitySchemes": {2 items},
"schemas": {28 items},
"responses": {0 items}
},
"security": [
0: {1 item},
1: {1 item}
]
}

Generated from the contract. Machine-readable spec: GET https://api.cardog.app/v2/openapi.json · markdown twin: /docs/reference/platform.md