List models by make

Retrieve the models for a manufacturer so you can select a modelId for the next step of the EV metadata discovery process.

Prerequisite

Browse available manufacturers and save the id of the manufacturer you want to query. Use this value as {makeId} in the following request.

For example, use renault to retrieve Renault models.

Retrieve models for a make

Use the /makes/{makeId}/models endpoint to retrieve the vehicle models available for a manufacturer. Each model has an id that you use as {modelId} when retrieving variants and their profileId values in further steps.

See the following sample request to learn how to get all models for a specific manufacturer:

Request example

curl "https://evprofiles.tourplanning.hereapi.com/v1/makes/renault/models?apiKey=YOUR_API_KEY"

Additional available parameters include:

• offset
• limit

Response

The following snippet shows the corresponding response, in the JSON format:

{
  "items": [
    {
      "id": "kangooExpress",
      "name": "Kangoo Express"
    },
    {
      "id": "kangooExpressZe",
      "name": "Kangoo Express ZE"
    },
    {
      "id": "kangooVanETechElectric",
      "name": "Kangoo Van E-Tech Electric"
    },
    {
      "id": "masterETechElectric",
      "name": "Master E-Tech Electric"
    },
    {
      "id": "masterZe",
      "name": "Master ZE"
    },
    {
      "id": "traficETechElectric",
      "name": "Trafic E-Tech Electric"
    }
  ],
  "limit": 10,
  "count": 6
}

Next steps

1. Save the ID of the target model for subsequent retrieval of a profileId. For example, when targeting Master E-Tech Electric, the corresponding unique model identifier is masterETechElectric.
2. Get all variants for a specific make and model combination, where each variant includes the corresponding profileId. For more information, see Obtain variants by make and model.