REST API

The same registry, over HTTPS.

Token-authenticated JSON endpoints for VIN checks, search history, and credit balance. API access is included on plans that list it. One credit per new VIN, exactly like the dashboard.

Token auth

One key per account. Regenerate any time from the console.

Credit metered

API and dashboard draw from the same balance. Repeat VINs are free.

Plain JSON

Trip totals, listing snapshots, and decoded identity per lookup.

Authentication

Exchange your credentials for a token, then pass it in the Authorization header on every request. Tokens are issued only to accounts with an active subscription.

POST /api/auth-token/
{"username": "you", "password": "********"}

Authorization: Token your_token_here

Endpoints

GET /api/vin/<vin>/

Check one VIN. Returns the total trips on record, the decoded identity, fleet percentile stats, and each rental history with its listing snapshots. Deducts one credit on first lookup of a VIN; repeats are free.

{
  "found": true,
  "cached": false,
  "vin": "WP0AB2A94LS227465",
  "summary": {
    "total_trips": 137,
    "listing_count": 2,
    "rental_history_count": 1,
    "identity": {"year": 2020, "make": "Porsche", "model": "911", "trim": "Carrera S"},
    "usage_stats": {"overall_percentile": 94, "fleet_median_trips": 11.0, ...}
  },
  "listings": [
    {
      "trips_on_record": 137,
      "current": {"tripCount": 137, "location": {...}, ...},
      "history": [...]
    }
  ]
}

GET /api/history/

Your search history, paginated at 25 per page (100 max). VIN, outcome, and timestamp per row. No credit cost.

GET /api/credit-usage/

Current credit balance. No credit cost.

GET /api/auth-token/verify/

Validates the token and returns the account it belongs to.

Example

curl https://dromos-registry.xyz/api/vin/WP0AB2A94LS227465/ \
  -H "Authorization: Token your_token_here"

Requests from accounts with an IP whitelist configured are accepted only from whitelisted addresses.

Create an account See pricing