# CSNB — Global Vehicle Data API

> CSNB provides vehicle registration and VIN lookups with one standardized
> JSON schema. Australia is live; the United States is in development.

CSNB is a vehicle data API platform. Machine-readable vehicle identity facts
(year, make, model, VIN, body type, transmission) are returned for a plate or
VIN, normalized across countries.

## Getting started

- API base: https://api.csnb.net
- OpenAPI spec: https://csnb.net/openapi.yaml
- MCP server: https://api.csnb.net/mcp (HTTP transport; requires a Bearer API key)
- Install snippet for MCP clients: https://csnb.net/.mcp.json

## Coverage

- AU (Australia): live for all states/territories (NSW, VIC, QLD, WA, SA, TAS, ACT, NT).
- US (United States): in development.

## Key facts for agents

- Auth: `Authorization: Bearer <api-key>` on /mcp and /agent routes.
- Pay-per-call agent lane: /agent/check returns HTTP 402 (x402, USDC on Base)
  until payment is confirmed; USDT (TRC20) support is planned.
- Errors are deterministic JSON with an `_meta` object (source/reason/confidence).
- Vehicle results are cacheable: same plate+VIN+state is stable for days.