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

# Mercedes Benz VDH Used Stock Management

The VDH Used Stock Management API saves used vehicles into the Mercedes-Benz VDH used stock and reads them back with all available attributes and texts. It changes a vehicle's status to drive the order process, retrieves the current status from the stock database, and bulk-assigns vehicles to marketplaces or removes them. It replaces the former VSE Vehicle Management Service interface and is available to retailers who hold a signed VDH contract.

## For AI agents

Save used vehicles to Mercedes-Benz VDH stock, read them back with full attributes, change vehicle status through the order process, and bulk-assign vehicles to marketplaces. For retailers with a VDH contract.

## Scope

Does not handle vehicle pricing, customer leads, or financing. Use for managing used-vehicle stock and marketplace assignment in VDH only.

## Capabilities

- Save a used vehicle to VDH stock with a slim or a full payload
- Read a vehicle from stock with all available attributes and texts
- Change a vehicle's status to drive the order process
- Retrieve a vehicle's current status from the stock database
- Bulk-assign vehicles to a marketplace or remove them
- Check the health of the VDH service

## Use cases

### Agent-managed used stock

An AI agent keeping a retailer's used inventory current saves each incoming vehicle to VDH and reads it back to confirm the stored attributes. The VDH Used Stock Management API accepts a slim or full save payload and returns the full record, so the agent can onboard a vehicle and verify it landed. Through Jentic the operations are discovered by intent and the OAuth token is injected at call time.

Example prompt: Save a used vehicle with the full payload and read it back to confirm the stored attributes

### Order-process status changes

As a used vehicle moves through sale and handover, its status has to change in the stock system. The VDH Used Stock Management API changes a vehicle's status to handle the order process and reads the current status back, so an agent can advance a vehicle through the process and confirm each transition.

Example prompt: Change a vehicle's status to the next order-process stage and read the status back to confirm the change

### Marketplace listing assignment

Retailers list used vehicles across several marketplaces. The VDH Used Stock Management API bulk-assigns vehicles to a marketplace and can remove them again, so an agent can publish a batch of stock to a marketplace and later unpublish it from one call rather than editing each listing by hand.

Example prompt: Bulk-assign a batch of vehicles to a marketplace and verify the assignment

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v1/vehicle/management/save/full` | Save a vehicle to VDH stock with the full payload |
| POST | `/v1/vehicle/management/save/slim` | Save a used vehicle with a slim payload |
| POST | `/v1/vehicle/management/read` | Read a vehicle with all attributes and texts |
| POST | `/v1/vehicle/management/status/change` | Change a vehicle's status in the order process |
| POST | `/v1/vehicle/management/marketplace/change` | Bulk-assign vehicles to a marketplace |
| GET | `/v1/vehicle/management/health` | Check the health of the service |

## Key resources

- **Save Vehicle** — Save a used vehicle to VDH stock with a slim or a full payload
- **Read Vehicle** — Read a vehicle from stock with all available attributes and texts
- **Change Vehicle Status** — Change a vehicle's status and read the current status from the stock database
- **Assign to Marketplaces** — Bulk-assign vehicles to a marketplace or remove them
- **Vehicle Management Health** — Check the health of the VDH service

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 70 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 66 / 100
  - Developer Experience & Jentic Compatibility: 86 / 100
  - AI-Readiness & Agent Experience: 58 / 100
  - Agent Usability: 94 / 100
  - Security: 85 / 100
  - AI Discoverability: 50 / 100
- **View full report:** https://jentic.com/apis/mercedes-benz.com/mercedes-benz/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the VDH Used Stock Management API by hand means running the OAuth client-credentials flow against the Mercedes-Benz SSO token endpoint, choosing the production or testing host, and shaping the slim or full save payload yourself. Through Jentic you install once, import it from the API Directory, store the client credentials once, and your agent calls it.
- **Permission scoping:** VDH carries the vehicle identifier in the request body, so rules bound which operations your agent may call, such as reading vehicles and their status. You choose the operation set, so the save, status-change, and marketplace-assignment operations are not included unless you add them.
- **Credential handling:** Your VDH OAuth client credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'save a used vehicle to stock' or 'change a vehicle status', and Jentic returns the matching VDH operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Smartcar** — Smartcar reads live data from connected vehicles across many brands.
- **Walmart Inventory Management** — Walmart's inventory API tracks stock levels for marketplace listings.
- **Shopify** — Shopify manages product catalogs, inventory, and storefront listings.

## FAQ

### What authentication does the VDH Used Stock Management API use?

The VDH Used Stock Management API uses OAuth 2.0 with the client-credentials flow, per its OpenAPI spec, obtaining a token from the Mercedes-Benz single sign-on token endpoint. Subscribing to the API requires a signed VDH contract. Through Jentic the client credentials are stored once and the token is injected at call time, so they never enter the agent's prompt, logs, or context.

### Can I bulk-assign vehicles to a marketplace with the VDH Used Stock Management API?

Yes. A marketplace-change operation assigns a batch of vehicles to a marketplace and can also remove or update the assignment, so an agent can publish or unpublish a group of vehicles in one call rather than editing each listing individually.

### What are the rate limits for the VDH Used Stock Management API?

The OpenAPI spec does not define numeric rate limits; they are governed by your VDH contract and the OneAPI portal. Have your agent back off when it receives an HTTP 429 response and consult the VDH product page for the limits that apply to your subscription.

### Is there a Mercedes-Benz VDH MCP server?

You don't need an MCP server to give your agent the VDH Used Stock Management API. Jentic connects it directly from the API Directory: import it, store your OAuth client credentials once, and your agent calls it. Operations are discovered on demand, so no extra tool definitions sit in the agent's context.

### Can I limit what my agent is allowed to do with the VDH Used Stock Management API?

Yes. VDH carries the vehicle identifier in the request body, so rules bound which operations your agent may call, such as reading vehicles and their status, rather than which vehicle. The save, status-change, and marketplace-assignment operations are not included unless you add them, and every call it makes is logged.

### How do I save a used vehicle through Jentic?

Search Jentic for an intent such as 'save a used vehicle to stock' and it returns the matching save operation with its input schema, so your agent posts the vehicle payload and reads back the stored record. To run it on your own infrastructure, install Jentic One from its GitHub repo.