canonical: https://jentic.com/apis/mydriverparis.com/mydriverparis

# MyDriverParis public booking API

The MyDriverParis public booking API prices private chauffeur trips in and around Paris before a customer books. It lists the fleet of vehicle classes with passenger and bag capacity and base rates, and computes an all-inclusive EUR price per vehicle class for a trip from a pickup address, a dropoff address, a pickup date, and a pickup time. Quotes cover one-way transfers, hourly hire with a minimum of 3 hours, and flat-rate trips, with an optional intermediate stop. A third endpoint receives Stripe payment webhooks and is for MyDriverParis's internal use only.

## For AI agents

List MyDriverParis vehicle classes with capacity and base rates, and get an exact all-inclusive EUR quote per vehicle class for a one-way, hourly, or flat-rate chauffeur trip in Paris.

## Scope

Does not create bookings, take payments, or track drivers in real time. Use for listing MyDriverParis vehicle classes and quoting chauffeur trips only.

## Capabilities

- List every MyDriverParis vehicle class with its passenger and bag capacity and base rate through GET /fleet
- Get an all-inclusive EUR price per vehicle class for a trip with POST /quote, from pickup_address, dropoff_address, pickup_date, and pickup_time
- Price hourly chauffeur hire by setting form_type to hourly and num_hours to 3 or more
- Add an intermediate stop to a quoted trip with step_address
- Compare one_way, hourly, and flat quotes for the same journey to choose the cheaper option

## Use cases

### A travel agent that quotes Paris transfers through Jentic

A trip-planning agent can price the ground leg of a Paris trip without anyone filling in a booking form. Through Jentic it finds the MyDriverParis quote operation by intent, calls GET /fleet to match passenger and bag counts to a vehicle class, then calls POST /quote with the pickup and dropoff addresses, a pickup_date in dd/mm/yyyy format, and a 24-hour pickup_time. The traveller gets an all-inclusive EUR price per vehicle class to choose from.

Example prompt: Call GET /fleet to find vehicle classes that seat 4 passengers with 4 bags, then call POST /quote with pickup_address 'Charles de Gaulle Airport Terminal 2E', dropoff_address 'Hotel Le Meurice, 228 Rue de Rivoli, Paris', pickup_date '14/11/2026', and pickup_time '09:30'

### Hourly chauffeur hire for events and tours

Meetings across town, a shopping day, or an evening event call for a driver on standby rather than a single transfer. POST /quote with form_type set to hourly and num_hours of at least 3 returns the all-inclusive EUR price per vehicle class for the booking window, so an assistant can compare a 3-hour and a 5-hour hire before the customer books.

Example prompt: Call POST /quote with form_type 'hourly', num_hours 4, pickup_address 'Place Vendome, Paris', dropoff_address 'Place Vendome, Paris', pickup_date '20/11/2026', and pickup_time '18:00', then report the price for each vehicle class

### Group and luggage-aware vehicle selection

Families and groups with lots of luggage need the right vehicle class, not just the cheapest one. GET /fleet returns each vehicle class with passenger and bag capacity and base rates, so an agent can rule out classes that do not fit before quoting, then use POST /quote to price only the classes that do.

Example prompt: Call GET /fleet, keep the vehicle classes with capacity for at least 7 passengers and 7 bags, then call POST /quote for an Orly Airport to Disneyland Paris trip on '22/12/2026' at '11:00' and report the prices for those classes

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/fleet` | List vehicle classes |
| POST | `/quote` | Compute an exact quote |

## Key resources

- **Fleet** — Vehicle classes with passenger and bag capacity and base rates
- **Quotes** — All-inclusive EUR prices per vehicle class for one-way, hourly, or flat-rate trips

## 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:** 46 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 56 / 100
  - AI-Readiness & Agent Experience: 23 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 54 / 100
- **View full report:** https://jentic.com/apis/mydriverparis.com/mydriverparis/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 MyDriverParis by hand means requesting a key by email, sending it in the X-API-Key header, and formatting pickup_date as dd/mm/yyyy rather than ISO. Through Jentic you install once, import the MyDriverParis public booking API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** MyDriverParis carries the trip details in the request body, so rules bound which operations your agent may call, not which trips it prices. You choose the operations it may call, so the internal Stripe webhook receiver is not included unless you add it.
- **Credential handling:** Your MyDriverParis API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'quote a Paris chauffeur ride' or 'list chauffeur vehicle classes', and Jentic returns the matching MyDriverParis operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Lyft API** — On-demand rides with ride-type estimates
- **aviationstack API** — Real-time and historical flight status data
- **Google Places API** — Place search and address details

## FAQ

### Is there a MyDriverParis MCP server?

You don't need an MCP server to give your agent MyDriverParis. Jentic connects it directly from the API Directory: import it, store your X-API-Key value once, and your agent calls it. Operations are discovered on demand, so no extra tool definitions sit in the agent's context.

### What authentication does the MyDriverParis public booking API use?

Per its OpenAPI spec, the API takes an API key in the X-API-Key header, and the spec says to request a key from contact@mydriverparis.com. Through Jentic, the key is stored encrypted by your own Jentic One instance and injected at call time, so it never enters the agent's context.

### Can I book and pay for a ride with the MyDriverParis public booking API?

Not from the documented endpoints. The spec exposes the fleet list and the quote calculation; the third endpoint, POST /stripe-webhook, is a Stripe payment receiver marked for internal use only and not intended for agents. Use the quote to present prices, then complete the booking through MyDriverParis.

### Can I limit what my agent is allowed to do with the MyDriverParis public booking API?

Yes. Write a rule that allows only GET /fleet and POST /quote. Your agent can then list vehicle classes and price trips, while the internal Stripe webhook receiver stays out of reach, and every call it makes is logged.

### What are the rate limits for the MyDriverParis public booking API?

The OpenAPI spec does not specify rate limits. Ask contact@mydriverparis.com when you request your API key.

### How do I get a chauffeur quote through Jentic?

Search Jentic for 'quote a Paris chauffeur ride', load the quote operation, and call POST /quote with pickup_address, dropoff_address, pickup_date, and pickup_time. Note that pickup_date is dd/mm/yyyy rather than ISO, and pickup_time is HH:MM on a 24-hour clock. To run it on your own infrastructure, install Jentic One from its GitHub repo.
