API Test Cases
Test your requests in a safe zero-cost way through our test case set.
You can use our test cases to confirm your implementation on our production endpoints. Requests using these values are not billable: sandbox responses carry sandbox: true and billable: false, and never reach an upstream data provider.
Test Cases
The test cases are all linked. In New Zealand, plate lookups resolve to the fake 2022 MG HS (vehicle ID 3333333333333333, VIN 00000000000000002). The Australian values (vehicle ID 1111111111111111, VIN 00000000000000000, a fake 2019 Toyota Corolla) and the EV values (vehicle ID 1111111111111112, VIN 00000000000000010, a fake 2023 Tesla Model Y) are accepted here as well, so one integration test suite can run against any regional endpoint.
Plates are matched case-insensitively and ignore spaces and hyphens.
Universal values
These work in every AutoGrab region.
Registration Plate
REG4SUCCESS
Returns a successful lookup response with a high-quality vehicle match for an ICE vehicle
Registration Plate
REG4SUCCESSEV
Returns a successful lookup response with a high-quality match for an EV
Registration Plate
REG4WARNING
Returns a successful lookup response with a low-match quality warning
Registration Plate
REG4NOMATCH
Returns the VIN and vehicle description but no matching vehicle
Registration Plate
REG4VINONLY
Only returns the VIN and no other vehicle details
VIN
00000000000000002
Returns a valid VIN match in New Zealand
VIN
00000000000000000
Returns a valid VIN match for an ICE vehicle (Australian fixture)
VIN
00000000000000010
Returns a valid VIN match for an EV
Vehicle ID
3333333333333333
Can be used for /predict, /predict/conditions, /residual or /sourcing. Returns the same fixed prediction every time
Vehicle ID
1111111111111111
Australian fixture, for the same endpoints
Vehicle ID
1111111111111112
The EV vehicle ID, for the same endpoints
New Zealand plates
A set in the NZ plate format for tests that validate plate shape before calling us. The ZZZ block of the LLLNNN series is decades from being issued, so no real vehicle can ever collide with these.
ZZZ111
Returns a successful lookup response with a high-quality vehicle match for an ICE vehicle
ZZZ222
Returns a successful lookup response with a high-quality match for an EV
ZZZ333
Returns a successful lookup response with a low-match quality warning
ZZZ444
Returns the VIN and vehicle description but no matching vehicle
ZZZ555
Only returns the VIN and no other vehicle details
Supported Endpoints
Test cases are supported across a range of API endpoints listed below. If the endpoint you are testing with is not listed get in touch to request test data.
/valuations/predict/valuations/vins/valuations/registrations/valuations/residual/valuations/predict/conditions/sourcing/market_overlay/sourcing/market_overlay/statistics
Implementation Guide
An example implementation could run a test as part of an integration test or development process. For example, you could test a valuation flow by first using a registration plate to get the ID (which is also test data) and send that to a /predict to get a valuation and a market overlay.
Was this helpful?