Run Service History Checks straight from your own systems. Send a VIN and get manufacturer dealer service records back as structured JSON. $7.69 per lookup that returns records, or $4.99 on the $99.99 a month plan.
curl -G "https://api.servicestamp.com.au/v1/service-history" \
-d vin=WVWZZZAUZKW284731 \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"result": {
"vehicle_identification_number": "WVWZZZAUZKW284731",
"service_events": [
{
"date_of_service_event": "2024-10-03",
"service_provider": "Harbourside Volkswagen, Parramatta NSW",
"mileage_observed": 60270,
"mileage_unit": "km"
}
]
}
}Put manufacturer service history wherever your team and your buyers already look, without anyone running checks by hand.
Check every trade-in as it's appraised, with the service records landing in your DMS or stock system automatically.
Show verified service history on your stock pages: the number of dealer services, the last service date and the odometer reading.
Add manufacturer service history to lot pages so buyers see it before bidding opens.
Check servicing across returning vehicles at end of contract, in bulk, without keying each one.
API access is part of an approved trade account. Talk to us and we'll switch it on; you then add a balance and create your keys in your trade dashboard. The monthly plan is optional.
One authenticated request per vehicle, with your key in the x-api-key header.
Each dealer service comes back with its date, odometer reading, the dealer that did the work and what was carried out, plus a link to the full ServiceStamp report.
One request per vehicle. Every dealer service on the manufacturer record comes back in service_events.
Base URL https://api.servicestamp.com.au/v1. The same endpoints also answer at https://servicestamp.com.au/api/v1.
Request
curl -G "https://api.servicestamp.com.au/v1/service-history" \
-d vin=WVWZZZAUZKW284731 \
-H "x-api-key: YOUR_API_KEY"Response
{
"success": true,
"result": {
"report_id": "rpt_8Kq2vX",
"report_url": "https://servicestamp.com.au/report/rpt_8Kq2vX",
"vehicle_identification_number": "WVWZZZAUZKW284731",
"registration_mark": null,
"vehicle": { "make": "Volkswagen", "year": 2019 },
"service_events": [
{
"date_of_service_event": "2024-10-03",
"service_provider": "Harbourside Volkswagen, Parramatta NSW",
"mileage_observed": 60270,
"mileage_unit": "km",
"service_type": "serviceVisit",
"service_items": [
{ "item_type": "Service", "item_description": "Engine oil and filter changed" },
{ "item_type": "Service", "item_description": "Dust and pollen filter replaced" }
]
}
]
}
}| Field | Meaning |
|---|---|
| date_of_service_event | When the service was carried out |
| service_provider | The dealer that did the work |
| mileage_observed / mileage_unit | Odometer reading at the visit, in km or mi |
| service_type | The type of visit |
| service_items | Each item of work carried out, with its category |
| report_url | The full ServiceStamp report, including the odometer timeline, to share with buyers or download as a PDF |
A value we do not have comes back as null, never missing: some manufacturers send no odometer unit or item category.
You're only charged when records come back.
| Code | Meaning |
|---|---|
| 200 | Records found. $7.69 is charged to your API balance, or $4.99 with the plan. |
| 202 | The manufacturer system is still processing. Retry after the Retry-After header. Not charged until records come back. |
| 204 | No manufacturer service records for this vehicle. Not charged. |
| 400 | Invalid VIN. |
| 401 | Missing, invalid or revoked API key. |
| 402 | Your API balance is empty. Top up in your trade dashboard. |
| 403 | API access is switched off or the trade account is not active. |
| 404 | No vehicle could be found for that VIN. Not charged. |
| 429 | Too many requests. Slow down and retry after the Retry-After header. |
| 503 | The lookup could not be completed on our side. Retry later. Not charged. |
Lookups come out of a prepaid balance at $7.69 each, and only when records come back. The optional $99.99 a month plan brings that to $4.99, pays for itself from 38 lookups a month, and can be cancelled whenever you like. Top up by card from $50.00 in your dashboard.
| Item | Price |
|---|---|
| Successful lookup, pay as you go | $7.69 |
| API plan (optional) | $99.99 a month |
| Successful lookup with the plan | $4.99 |
A lookup that finds no manufacturer service records costs nothing, exactly as it works for trade checks in the dashboard.
A "still processing" response is never charged. Call again when it's ready and you pay once.
The API returns manufacturer dealer service records for 20 brands, for cars from 2012 onwards. How much detail each record carries depends on the manufacturer.
Records come from manufacturer systems, so they show servicing carried out by franchised dealers. Work done outside the dealer network isn't held in those systems. The Service History Check page has the full coverage detail by brand.
API access is available to approved ServiceStamp trade accounts. Talk to us about what you're building and we'll switch it on. You then add a balance and create and manage your own live and test keys from your trade dashboard. The monthly plan is optional: it lowers the per-lookup price.
Yes. Send the 17-character VIN. The API does not look a vehicle up from its plate, so a rego on its own cannot be checked.
Lookups usually complete in a single call. If a manufacturer system needs longer, you get a 202 response with a Retry-After header. Call again after that: your call asks the manufacturer again, so it can take a few seconds, and you're only charged once.
$7.69 for each lookup that returns records, taken from a prepaid balance you top up by card in your trade dashboard ($50.00 to $10,000.00 a time). The optional plan is $99.99 a month per trade account and brings each lookup to $4.99, so it pays for itself from 38 lookups a month. A lookup that finds no manufacturer service records costs nothing, and the same vehicle within 24 hours is free. You can cancel the plan at any time; it runs to the end of the month you have paid for.
Live lookups answer 402 until you top up. We email you when the balance drops below $50.00 and again if a lookup is refused. Test keys keep working.
A second lookup of the same vehicle from your account within 24 hours returns the report you already have and uses no credit. That is also why a retry after a 202 is never charged twice.
Yes. Ask for a test key (it starts ss_test_). It returns a sample report for any valid VIN, never charges your balance and never contacts the manufacturer systems. The VIN TEST0000000000204 returns the no-records response and TEST0000000000202 the still-processing response, so you can build for every path before going live.
Yes, 60 requests a minute per account by default, shared across your keys. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. If you need more, tell us.
No. The API covers Service History Checks: the dealer service records the manufacturer holds for a VIN. Whether money is owing on a car, or whether it has been written off or stolen, comes from a PPSR check, which is a different product.
Yes. Every lookup appears in your trade dashboard alongside the checks you run there, so your whole team can see them.
Yes. Every response includes a report_url for the full ServiceStamp report, which you can share with a buyer or download as a PDF.
Tell us what you're building and roughly how many vehicles you check a month, and we'll get you set up.
Or email hello@servicestamp.com.au
Flat trade pricing from $7.99 per check, plus dedicated support and a team dashboard.