Understand EV Profiles API response format
The following sections provide a quick reference information for all API response parameters.
Pagination
The API uses pagination allowing you to retrieve results in smaller, manageable chunks (pages). This improves performance and reduces response times when dealing with extensive vehicle catalogs and enables features like a systematic navigation through large vehicle catalogs.
The response includes a nextOffset field that contains the offset value for the next page. This field is only present when more results are available. Use this value in your next request’s offset parameter to get the following page.
See the following request examples for most common pagination use cases:
# Get first 20 makes for initial page load
curl "https://evprofiles.tourplanning.hereapi.com/v1/makes?limit=20&apiKey=YOUR_API_KEY"
# Get next page using nextOffset from previous response
curl "https://evprofiles.tourplanning.hereapi.com/v1/makes?offset=20&limit=20&apiKey=YOUR_API_KEY"
# Get just 5 items for a dropdown menu
curl "https://evprofiles.tourplanning.hereapi.com/v1/makes?limit=5&apiKey=YOUR_API_KEY"Request parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
offset | integer | no | 0 | N/A | Starting position (number of items to skip) |
limit | integer | no | 10 | 1-100 | Maximum number of items to return |
Response Properties
| Property | Type | Description |
|---|---|---|
nextOffset | integer | Offset value for the next page of results (only present when more results are available) |
limit | integer | Current limit used in the request |
count | integer | Number of items in the current response |
items | array | Array of result objects |
Vehicle variant properties
Vehicle variants include comprehensive technical specifications:
| Property | Type | Description |
|---|---|---|
profileId | string | ID of the electric vehicle profile for this variant (some variants may share the same profile) |
width | integer | Vehicle width in millimeters (excluding mirrors) |
height | integer | Vehicle height in millimeters |
unladenWeight | integer | Empty vehicle weight in kilograms (without cargo or passengers) |
grossWeight | integer | Maximum allowed vehicle weight in kilograms (including cargo and passengers) |
range | integer | Electric driving range in kilometers under standardized test conditions (WLTP). This represents the maximum distance the vehicle can travel on a single charge under optimal conditions. Real-world range may vary based on driving conditions, weather, and usage patterns. |
releaseYear | integer | Vehicle release year |
bodyType | string | Vehicle body type (for example, "Panel_Van") |
lengthClasses | array | Length classifications by country (array of class and country objects) |
weightClasses | array | Weight classifications by country (array of class and country objects) |
heightClasses | array | Height classifications by country (array of class and country objects) |
versions | array | Marketed version names by country (array of label and country objects) |
Note
Country information is provided using ISO 3166-1 alpha-3 country codes. The list of supported countries is limited to those where vehicle classifications are defined. Currently supported countries include:
DEU(Germany)GBR(Great Britain)NLD(Netherlands)When the country field is null or not present, it indicates a general classification that applies to most European countries. Country-specific classes override the general classification.
Next steps
For more information about how to make requests to each available EV Profiles API endpoint, see Get EV metadata with the HERE EV Profiles API.
Updated 3 months ago