Bulk lookups

Need to check many vehicles at once? Send them in a single bulk request instead of looping one at a time.

How to call it

POST a vrms array (up to 50 registrations) to any vehicle product's live endpoint:

curl -X POST "https://vehiclematic.com/products/vehicle-details/api/live/bulk" \
  -H "X-VEHICLEMATIC-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"vrms":["AB12CDE","XY19ZZZ","LP68MNO"]}'

The registrations can also be supplied as a comma- or space-separated list. The response contains a data array with one result per registration, plus your remaining credit_balance.

Billing

Bulk is billed the same way as single lookups: one charge per successful vehicle. Registrations served from cache don't cost another credit, and any that can't be resolved aren't charged.

CSV output

Add ?format=csv to receive the results as CSV rows rather than JSON — ideal for feeding a spreadsheet or a downstream import.

Tips

• Keep batches at or below 50 registrations; split larger jobs into multiple requests.
• Mind the rate limit when firing many batches in quick succession.
• Use an Idempotency-Key if you retry a batch, so you're never double-charged.