BeakCheck API
Get a key
A trial key gives 50 calls a month, free, no card. It arrives by email within a minute.
Authentication
Send the key as a bearer token on every request. Keys are stored hashed; if you lose one, reply to the key email and we rotate it.
curl -H "Authorization: Bearer bk_..." "https://beakcheck.com/api/v1/vehicle?reg=AB12CDE"
Endpoints
GET /api/v1/vehicle?reg=
The DVLA record: make, colour, fuel, engine capacity, CO2, year of manufacture, tax status and due date, MOT status and expiry, first registration, Euro status where held, export marker. One call.
GET /api/v1/mot-history?reg=
Every MOT test since 2005: date, result, odometer reading, expiry, defects by category (dangerous, major, minor) and advisories, plus the model name DVSA holds. One call.
GET /api/v1/remap?reg= or ?q=golf 2.0 tdi 2015
Matches the registration to one of 2,155 engines and returns stock, Stage 1 and Stage 2 bhp and Nm, the hardware each stage needs, a risk score out of 10 with the reasons, and a quote link. With q it returns up to ten text matches. One call (by registration it also fetches the two records above, counted once).
GET /api/v1/usage
Your plan, calls used this month and the quota. Not counted.
Example
{
"registration": "YS19PFZ",
"name": "Ford Edge 2015 (Diesel, 207 bhp)",
"stock": { "bhp": 207, "nm": 450 },
"stage1": { "bhp": 240, "nm": 520, "gainBhp": 33, "gainPct": 16, "hardware": "Software only" },
"stage2": { "bhp": 255, "nm": 550, "gainBhp": 48, "hardware": "Uprated intercooler, high-flow intake" },
"risk": { "score": 3, "label": "Low", "factors": ["..."], "mitigations": ["..."] },
"url": "https://beakcheck.com/remap/ford/edge-2015-diesel-2-0l-207hp"
}
Limits and errors
| Code | HTTP | Meaning |
|---|---|---|
| NO_KEY, BAD_KEY | 401 | Missing, wrong or revoked key |
| NOT_FOUND | 404 | DVLA or DVSA has no record for that registration |
| RATE_LIMITED | 429 | More than 60 requests in a minute |
| QUOTA | 429 | Monthly calls used; X-RateLimit-Remaining is sent on every response |
| UPSTREAM | 502 | DVLA or DVSA did not answer; retry with backoff |
Plans
Monthly plans for garages, tuners and dealers (Garage: 2,000 calls, Tuner: 10,000 calls) are priced on request while the API is in its first months. Email support@beakcheck.com with your expected volume.
Terms
Data is sourced live from the DVLA Vehicle Enquiry Service and the DVSA MOT history service and is for your own business use: no reselling the raw feed, no bulk harvesting, and registration numbers are personal data so handle them under UK GDPR. Remap figures are published results for that engine and are a guide, not a promise. The usual terms and privacy policy apply.