API & Integration
Authenticate, call the endpoints, run bulk lookups and receive webhooks.
-
Authenticating your API requests
Every request is authenticated with your API key in the X-VEHICLEMATIC-KEY header.
-
Creating and scoping API keys
Create multiple keys, scope each one to specific products, and enable, disable or revoke them.
-
Making a lookup: request and response
Call a product endpoint by registration and get normalised JSON, your credit balance and cache status back.
-
Bulk lookups
Look up as many as 50 registrations in one request, with one charge per successful vehicle.
-
Rate limits and reliable requests
Understand per-key rate limits and use idempotency keys for exactly-once billing on retries.
-
Setting up webhooks
Subscribe your own endpoints to account events, verify them with an HMAC signature, and send a test.
Still need help?
Our team is happy to help with integration or billing questions.