Skip to content

Car Configurator API

by mercedes-benz.com

No authHTTPSTransportation
Open documentation ↗

Overview

The Car Configurator API offers access to the Mercedes-Benz car configuration functions. It provides required reference data such as the masterdata of all Mercedes-Benz vehicles as well as functions to retrieve initial and changed configurations. In addition to that is is possible to save a newly created configuration so that it can be easily restored or shared with others.

Car Configurator is a transportation API from mercedes-benz.com. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 24 endpoints.

At a glance

Authentication
No auth
HTTPS
Yes
CORS
Unknown
Base URL
https://api.mercedes-benz.com/configurator_tryout/v1
Version
1.0
Endpoints
24
Spec updated
2019-03-12

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.mercedes-benz.com/configurator_tryout/v1/markets" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://api.mercedes-benz.com/configurator_tryout/v1/markets", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://api.mercedes-benz.com/configurator_tryout/v1/markets",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/marketsGet all available markets.
GET/markets/{marketId}Get the market with the given marketId.
GET/markets/{marketId}/bodiesGet all available bodies for the given marketId.
GET/markets/{marketId}/bodies/{bodyId}Get the body for the given marketId and bodyId.
GET/markets/{marketId}/classesGet all available classes for the given marketId.
GET/markets/{marketId}/classes/{classId}Get the class for the given marketId and classId.
GET/markets/{marketId}/modelsGet all available models for the given marketId.
GET/markets/{marketId}/models/{modelId}Get the model for the given marketId and modelId.
GET/markets/{marketId}/models/{modelId}/configurations/initialGet the initial configuration for the given marketId and modelId.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}Get the configuration for the given marketId, modelId and configurationId.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/alternatives/{componentList}Get the alternatives for the given marketId, modelId, configurationId and componentList.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/componentsReturns URLs pointing to images in JPG format in the highest available resolution (depending on the component) of the vehicle's:
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/engineReturns a URL pointing to an image of the vehicles engine. These images are available in the resolution 1024x576 px.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/equipmentsReturns URLs pointing to images of this vehicle's equipments. The images are available in the highest possible resolution (usually 740x416 px).
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/equipments/{componentCode}Returns URLs pointing to images of this vehicle's equipments. The images are available in the highest possible resolution (usually 740x416 px).
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/paintReturns URLs pointing to images of this vehicles paint. These images are available in resolution 800x600 px. Note there might be two paints (e.g. Smart, 'pain
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/rimReturns a URL pointing to an image of the vehicles rim. These images are available in the resolution 710x710 px.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/trimReturns a URL pointing to an image of this vehicles trim. These images are available in resolution 800x600 px.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/components/upholsteryReturns URLs pointing to images of the vehicle's upholsteries. Tge images are available in the highest possible resolution (usually 800x600 px).
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/images/vehicleReturns URLs pointing to PNG images of a vehicle with a white background.
GET/markets/{marketId}/models/{modelId}/configurations/{configurationId}/selectablesGet the selectable components for the given marketId, modelId and configurationId.
POST/markets/{marketId}/onlinecodeStores the configuration of the given configurationId and modelId
GET/markets/{marketId}/onlinecode/{onlineCode}Get the configuration of the given onlineCode and marketId.
GET/markets/{marketId}/productgroupsGet all configured active product groups for the given marketId.

Questions

Does the Car Configurator API need an API key?

No. The Car Configurator API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the Car Configurator API support HTTPS?

Yes, the Car Configurator API is served over HTTPS.

How many endpoints does the Car Configurator API have?

Its OpenAPI description lists 24 endpoints in version 1.0. All of them are shown on this page.

What are alternatives to the Car Configurator API?

Other Transportation APIs include airportsapi, Transport for London, England, Uber, Transport for Spain, Amadeus for Developers.

Compare alternatives →

Listed from APIs.guru (CC0).