Getting Started
Welcome to the JATO Developer Portal, here you’ll find everything you need to start working with our JaaS (JATO as a Service) APIs.
Step 2 - API Credentials
As part of your setup, you’ll receive the following credentials for the relevant APIs in your contract or trial agreement:
Primary & Secondary Subscription Keys (supplied per product)
Client ID & Client Secret
These credentials are unique to your organisation and required for authenticating and testing API requests.
For WLTP Link and Code Link customers only, you will be supplied:
Primary & Secondary Subscription Keys
Assigned Email & Password
Step 1 - Requesting Access
Public Users: You can explore all documentation within the developer portal without login. To test our APIs, you’ll need to request a free trial.
Trial/Existing Customers: If you've been approved for a trial or are an exisiting customer, you will need to 'Sign In' to access your API keys. Please click 'Sign In' below, and select the 'JATO Account' button.
Step 3 - Authentication
All our APIs support OAuth 2.0 authentication.
To authenticate:
1. Request a OAuth 2.0 JWT token from the appropriate Authorisation endpoint, depending on the API you're using:
The OAuth 2.0 JWT token is needed to use our API endpoints.
2. Include your Subscription Key in the headers:
You can use either your Primary or Secondary Subscription Key. They offer identical access and functionality - if one key is ever compromised, expires, or is accidentally deleted, the other serves as a seamless backup.
3. Use your client Id and client secret in the request body:
Once authenticated, you’ll receive an access token valid for 60 minutes.
If you do not have client credentials or need to re-generate your client secret, please contact JATO Support.
.png)
Step 4 - Make your first API Call
Once authenticated, you can use the “Try it” tool in each API to:
Explore API calls with examples and code
Understand required inputs and response formats
Core Concept: the JATO Instance ID
JATO’s data infrastructure is powered by a single, unifying element: the Instance ID – our unique identifier for every vehicle instance globally.
How do I obtain a JATO Instance ID?
Utilise the JATO Index API (our search API) which allows you to discover, search and filter JATO’s full vehicle catalogue across all markets using high level meta data.
Decode a VIN or VRM using our VINView API, which will return a valid matching JATO Instance ID.
What can I do with an Instance ID?
Once you have obtained the required Instance ID for a given vehicle, you can:
Retrieve both OEM-defined standard equipment and options, packs, colours (with official codes & pricing): Specifications API > Vehicle Content endpoint.
Retieve the Build Rules to understand interdependencies between options and standard specifications: Specifications API > Options Build endpoint.
Compare multiple vehicle Instance IDs side-by-side, highlighting feature differences: Specifications API > Compare endpoint.
Gain insight into Incentives offers: Specifications API > Incentives endpoint.
Taxonomy
Responses are structured according to the JATO Taxonomy, identified by its 'taxonomyId'.
Default taxonomyId: a5c0988c-44ea-877a-882f-4c99d9bb89b9 (~250 datapoints).
Without a taxonomyId, specification endpoints will return 50 datapoints.
Custom taxonomy is available - please contact your Support representative and Account Manager for details.
Resources
Browse our API Solutions.
Explore Documentation for complete documentation of all endpoints.
Postman Collection: Import our API into Postman for easy testing:
Need help? Contact JATO Support.