canonical: https://jentic.com/apis/mercedes-benz.com/mercedes-benz-dealer-api

# Mercedes Benz Dealer

Jentic publishes the only available OpenAPI specification for Dealer, keeping it validated and agent-ready. The Mercedes-Benz Dealer API exposes the official authorised dealer directory: a country reference list and a dealer search returning addresses and identifiers for each dealership. The data matches the public dealer locator on mercedes-benz.com, suitable for embedding a 'find a Mercedes dealer' experience inside a third-party app or agent flow.

## For AI agents

Search the official Mercedes-Benz dealer directory by country and retrieve full dealer profiles by ID across 3 endpoints.

## Scope

Does not handle dealer inventory, appointment scheduling, vehicle pricing, or service bookings - use for looking up authorised Mercedes-Benz dealer locations only.

## Capabilities

- List the countries where Mercedes-Benz operates an authorised dealer network
- Search the Mercedes-Benz dealer directory filtered by country
- Retrieve a dealer's full profile, including address and identifiers, by dealerId
- Power a 'find your nearest Mercedes-Benz dealer' UI inside a third-party site or app
- Verify whether a given dealer ID is recognised in the official Mercedes directory

## Use cases

### Embed a Mercedes-Benz dealer locator

Marketplace and comparison sites embed the official Mercedes-Benz dealer locator instead of scraping mercedes-benz.com. /countries scopes the query, /dealers returns the matching dealerships, and `/dealers/{dealerId}` fills in the full record. The directory stays in sync with the official locator as dealers open or close.

Example prompt: GET /countries, then GET /dealers?countryCode=DE for German dealers, then GET `/dealers/{dealerId}` for the first result to obtain the full address.

### Hand-off after a saved configuration

After a customer saves a build via the Mercedes Car Configurator, the Dealer API converts a country code into a list of nearby dealers. This closes the loop between online configuration and in-person purchase without leaving the integrating app.

Example prompt: GET /dealers with the customer's countryCode, then surface the top three dealers ranked by distance from the user's coordinates.

### Aftersales and breakdown routing

Service apps route an owner to the nearest authorised Mercedes-Benz workshop. /dealers filtered by country returns a candidate list, and `/dealers/{dealerId}` confirms the address. The directory's authoritativeness reduces the risk of routing a customer to a non-authorised garage.

Example prompt: Filter /dealers by countryCode, sort by distance from the user's location, and return the closest dealer's record from `/dealers/{dealerId}.`

### Agent-driven dealer search via Jentic

An AI assistant uses Jentic to look up an authorised Mercedes-Benz dealer in the user's country. Jentic securely stores the apiKey and exposes /dealers by intent, so the agent calls the operation with a country code and returns a normalised dealer list in chat.

Example prompt: Search Jentic for 'find a mercedes-benz dealer', load the /dealers schema, execute it with countryCode=GB, and return the top dealer's name and address.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/countries` | List supported countries |
| GET | `/dealers` | Search authorised Mercedes-Benz dealers |
| GET | `/dealers/{dealerId}` | Retrieve a single dealer's full profile |

## Key resources

- **Countries** — Reference list of countries with Mercedes-Benz dealer coverage
- **Dealers** — Authorised Mercedes-Benz dealerships with addresses and identifiers

## Why Jentic

- **Setup:** Wiring the Mercedes-Benz Dealer API by hand means getting a developer-portal apiKey, attaching it to each call against the dealer_tryout host, and paging through countries and dealers yourself. Through Jentic you install once, import the Dealer API from the API Directory, store the apiKey once, and your agent calls it.
- **Permission scoping:** The Dealer API puts the dealer id in the URL path (`/dealers/{dealerId}`), so a rule can pin your agent to one dealer record. Every operation here is a read-only GET for looking up countries and authorised dealers, so a rule can grant those lookups without exposing any write.
- **Credential handling:** Your Mercedes-Benz apiKey is stored once, encrypted, by your own Jentic One instance and injected at request time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find a Mercedes dealer' or 'list Mercedes countries', and Jentic returns the matching Dealer API operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Car Configurator** — Builds and saves Mercedes-Benz configurations the Dealer API can route to a local dealership.
- **Vehicle Image** — Provides high-resolution Mercedes-Benz imagery for dealer listing pages.
- **Auto Dealer Data** — Multi-brand US dealer data covering many manufacturers, broader than Mercedes alone.

## FAQ

### Why is there no official OpenAPI spec for Dealer?

Mercedes-Benz does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Dealer via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Mercedes-Benz Dealer API use?

The Dealer API uses an apiKey from the Mercedes-Benz developer portal in the request header. Jentic stores the apiKey in its encrypted vault and injects it at execution time.

### Can I get a full address for a specific Mercedes-Benz dealer?

Yes. GET `/dealers/{dealerId}` with the dealer's identifier returns the dealership's address and contact identifiers.

### What are the rate limits for the Mercedes-Benz Dealer API?

The spec does not publish numeric limits. Production traffic is throttled per developer portal contract; the public tryout host is intended for evaluation only.

### How do I find dealers in a specific country through Jentic?

Search Jentic for 'find a mercedes-benz dealer', load the /dealers schema, and execute it with the relevant countryCode parameter. The agent receives the dealer list it can rank or display.

### Does the Dealer API include opening hours or service availability?

No. The spec exposes /countries, /dealers, and `/dealers/{dealerId}` only. Opening hours and live service availability are not in the directory - pair with a dealer's own scheduling system for that.

### Can I limit what my agent is allowed to do with the Mercedes-Benz Dealer API?

Yes. Because you self-host Jentic One, your own rules decide which of this API's operations your agent may call, and every operation here is a read-only GET for looking up countries and authorised dealers, so you can grant those lookups without exposing any write. Since the dealer id sits in the URL path at GET `/dealers/{dealerId}`, a rule can pin the agent to a single dealer record or restrict it to country and search calls such as GET /countries and GET /dealers. You configure these scopes, and the stored apiKey is injected only when a permitted operation runs.