Knowledge Base

You can use our sandbox for free without the need to sign up to a plan,  and using Postman is a great way to test our API and start your development. 

1. Sign in to your One Auto API account or for brand new customers see Creating an account. 

2. Select Account and Your Plan.

3. Click Download Latest Postman Collection.

4. Open Postman (if you don’t have access to Postman already, you can sign up for free from the Postman website).

5. Click Import and select the Postman Collection file.

6. The file will import and create a new One Auto API folder containing the Postman collection.

Before you can make a call, you’ll need to authenticate your requests with an API key.

1. Sign in to your One Auto API account.

2. Select API Admin then API Keys.

3. Click Generate API Key, give your key a name (e.g. ‘Sandbox Key’) and click Generate Key.

4. Copy your key and add it as the Value in the Authorisation section of the One Auto API Postman collection.

There’s a folder for each service and supplier. With your Postman collection authenticated you now just need to add the sandbox variable and then you’re ready to go.

1. Open Postman and select the One Auto API collection.

2. Click Variables.

3. Add the new variable baseURL.

4. Add the Sandbox URL: https://sandbox.oneautoapi.com as the initial and current value.

5. Click Save.

6. Select the One Auto API folder again.

7. Select the chosen supplier, service, version folders.

8. Select the (GET) endpoint.

9. Add an actual ‘value’ against the parameter(s) on the Params tab*. For example add a real VRM to the vehicle_registration_mark field. 

10. Click Send.

* Please note if using an endpoint requiring a Date fields please follow the format yyyy-mm-dd.