Partner API
Call the partner API from your server using its assigned credential.
https://api.stage3digital.co.uk
| Endpoint | Returns |
|---|
| POST /v1/vehicles/report | MOT tests, mileage and evidence-backed vehicle facts |
| POST /v1/vehicles/lookup | Registration-level summary |
| GET /v1/usage | Your account’s usage |
Vehicle request
Send JSON with one field, {"registration":"AB12CDE"}. Supply your bearer credential in the Authorization header and one random Idempotency-Key per deliberate lookup. Keep both the registration and the credential out of URLs.
Handling the result
Use the source and capture date alongside each recorded fact. The service reports unsupported checks explicitly. Historical mileage or an advisory alone does not establish fraud or a current fault.
A 401 response requires a valid credential. A 403 indicates missing permission. Respect Retry-After on 429. Reuse the same operation ID after an interrupted request. Completed reports are discarded, so a repeat can return replay_unavailable. Starting a new lookup can consume quota.