Duplicate of the verified Samuelz Chauffeur Booking connector: https://glama.ai/mcp/connectors/com.samuelz.platform-api/samuelz-chauffeur-booking
Chauffeur price previews and consent-led offers for the provider's published service areas.
Scored across 5 tools
Each tool owns a distinct step of the booking funnel (discovery, terms, pricing, offer creation, offer recovery) and the descriptions explicitly route callers away from the wrong tool ("Do not use for terms, use get_customer_policy instead"). The prepare_offer vs. get_offer_status boundary (create vs. recover a submission) and quote_ride vs. prepare_offer boundary (price vs. unpaid offer) are clearly stated.
All five names are snake_case verb_noun pairs (get_customer_policy, get_offer_status, get_service_options, prepare_offer, quote_ride). Verbs are used consistently by intent: get_* for reads, prepare_/quote_ for creating artifacts.
Five tools is tightly scoped to the domain and none is redundant: one read each for services, policy and status, plus quote and offer preparation. Nothing feels like filler or like a missing sibling tool.
The funnel is covered end to end: discovery, terms, pricing, offer preparation with a private checkout URL, and post-timeout recovery of the recorded booking state. Gaps exist around post-booking lifecycle operations such as cancellation or modification, which the agent cannot perform through this surface.
Use this when checking Samuelz Chauffeur lead time, account requirements and booking confirmation terms. Do not use for service coverage (use get_service_options instead). Returns available with observedAt and terms, or unavailable. Lead time is in minutes; interpret dates in the returned time zone and revalidate terms on the eventual offer. This cheap, repeatable read creates nothing. Pass a published offerKey for its location’s terms; omit it for default policy.
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility. | en |
| offerKey | No | Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant. |
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent and non-destructive, and the description reinforces this with 'This cheap, repeatable read creates nothing'. It adds value beyond the annotations by disclosing the return shape ('available with observedAt and terms, or unavailable'), lead-time units in minutes, and a time-zone/staleness caveat ('revalidate terms on the eventual offer').
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The usage trigger and exclusion are front-loaded in the first two sentences, and the later sentences cover return shape, units and defaults. It is dense but earns most of its length; the 'cheap, repeatable read creates nothing' clause slightly overlaps with what the annotations already state.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description still supplies the interpretation rules an agent needs: lead time is in minutes, dates use the returned time zone, and terms should be revalidated before a booking. Nothing required to call or interpret this tool correctly appears to be missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both parameters are already fully documented, including the locale enum and offerKey pattern. The description's note that offerKey selects a location's terms and should be omitted for the default largely restates the schema, so the baseline of 3 applies rather than a premium.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb-plus-resource ('checking ... lead time, account requirements and booking confirmation terms') and immediately scopes it against a named sibling by excluding service coverage. An agent can decide between this and get_service_options without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives an explicit when-to-use trigger, an explicit when-not ('Do not use for service coverage') with the alternative tool named, and a parameter-selection rule ('Pass a published offerKey for its location's terms; omit it for default policy'). Alternatives and exclusions are both covered.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Use this when recovering a submitted offer after a timeout or on return. Do not use for new requests (use prepare_offer instead).
For rides A then B, pair A's submissionId with A's resumeToken to read A, even after B. Recovery preserves the original language: there is no locale override.
pending: retry after retryAfterSeconds; prepared: private checkout/terms links; available: recorded booking state. not_found does not prove creation failed: check the pair and provider before another attempt.
The private pair authorizes this stored read without login and expires 24 hours after first submission. There is no provider refresh. Recorded flags do not prove fresh payment or availability.
| Name | Required | Description | Default |
|---|---|---|---|
| resumeToken | Yes | Original private 64-character hexadecimal resumeToken sent with this submissionId. Reuse it unchanged; never generate a replacement. Expired, invalid or foreign-provider proof can return not_found without proving that no booking exists. | |
| submissionId | Yes | Original submissionId UUID sent to prepare_offer for this attempt, including when its response was lost. Reuse it with the original resumeToken; do not generate a new ID or substitute a booking ID. |
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the readOnly/idempotent annotations, it discloses the private-pair authorization model (no login), the 24-hour expiry after first submission, no provider refresh, and the meaning of each status (pending: retry after retryAfterSeconds; prepared: private links; available: recorded booking state). It also warns that not_found does not prove creation failed and that recorded flags do not prove fresh payment or availability.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the use/don't-use distinction, then status semantics, then auth/expiry caveats. Dense but waste-free; the status-list sentence is slightly compressed and would read better as a list, but nothing is filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Output schema exists, yet the description still explains status outcomes and the retryAfterSeconds follow-up, plus the key false-negative trap around not_found. Nothing an agent needs to call or interpret this tool is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3; the description still adds meaning by specifying the cross-attempt pairing rule (A's ID with A's token, even after B) and that there is no locale override on recovery. These are behavioral constraints on the parameters beyond the schema's 'reuse unchanged' text.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource (recover/read a submitted offer status) and immediately names the sibling it is not (prepare_offer) for new requests. An agent can distinguish it from prepare_offer and quote_ride without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit when-to-use ('recovering a submitted offer after a timeout or on return') and when-not-to-use ('do not use for new requests (use prepare_offer instead)'). It also adds a concrete sequencing rule for multi-ride flows (pair A's submissionId with A's resumeToken even after B is submitted).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Use this when discovering Samuelz Chauffeur services, areas and time zones. Do not use for terms (use get_customer_policy instead). Keep offerKey and locale across policy/price calls so location and language agree; omit the key for discovery. Returns available or unavailable. Anonymous stored read; no price, availability confirmation or writes.
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility. | en |
| offerKey | No | Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant. |
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds context the annotations cannot: this is an anonymous (no auth) stored read of published data, it returns an available/unavailable state, and it does not confirm availability or return price — useful for knowing the data is a snapshot rather than a live check.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Four short clauses, each doing distinct work: when to use, when not to use and the alternative, cross-call parameter persistence, and the return/negative-scope statement. Front-loaded with the usage condition and zero filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Output schema covers the return shape and annotations cover safety, so the description only needs routing, parameter persistence and scope limits — all of which it provides, including the explicit note that neither price nor availability confirmation is returned.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3; the description goes beyond it by stating to persist offerKey and locale across related calls and to omit offerKey for discovery, which is cross-parameter usage guidance the schema does not spell out. It does not add much about locale switching beyond what the schema already says.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a concrete verb (discovering) and concrete resources (services, areas, time zones) for a named provider, and explicitly excludes terms retrieval. An agent can tell it apart from get_customer_policy without opening either schema, though the phrasing is slightly list-like rather than a single crisp statement of purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives an explicit when-to-use clause ('when discovering Samuelz Chauffeur services, areas and time zones'), an explicit when-not clause naming the correct alternative ('Do not use for terms (use get_customer_policy instead)'), plus a cross-call rule to carry offerKey/locale into policy/price calls and omit the key for pure discovery.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Use this when preparing a customer-requested unpaid Samuelz Chauffeur offer (offerRequested=true). Do not use for prices (use quote_ride instead). Supply email or E.164 phone. Bind submissionId/resumeToken to unchanged ride, contact, locale, offerKey and partner context. Intake and unpaid state may persist after disconnect. Recover with get_offer_status and the original pair. prepared returns private checkoutUrl for customer confirmation/payment before offer.expiresAt. Wait retryAfterSeconds if given; review conflict/ambiguous. This call does not charge or confirm, dispatch or send messages.
| Name | Required | Description | Default |
|---|---|---|---|
| ride | Yes | Pickup, destination, local date, time and passengers. | |
| locale | No | Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility. | en |
| contact | Yes | Customer email or phone for this requested offer. | |
| offerKey | No | Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant. | |
| resumeToken | Yes | Caller-generated private secret of 64 hexadecimal characters. Generate once, retain it with submissionId for recovery, and never share the pair publicly or replace it on uncertain retries. | |
| submissionId | Yes | Create one UUID for one explicitly requested offer, for example 123e4567-e89b-42d3-a456-426614174000. Retain it with the original resumeToken and unchanged request on retries. | |
| offerRequested | Yes | True only after the customer explicitly asks for an offer. | |
| specialRequests | No | Optional requirements, at most 500 characters. | |
| firstTouchTrackingToken | No | Existing first-touch token. Never invent one. | |
| distributionPartnerCapability | No | Existing dp_live_ partner token. Omit for customers. |
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the safety/idempotency profile, and the description adds substantive context beyond them: intake and unpaid state may persist after disconnect, the call does not charge/confirm/dispatch/send messages, and success returns a private checkoutUrl bounded by offer.expiresAt. It also explains retry semantics (bind submissionId/resumeToken to an unchanged request), which is exactly the kind of behavior an agent needs before a mutating-looking call.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the trigger condition and the exclusion first, then behavior, then recovery — a good ordering with essentially no filler. It is written in dense telegraphic fragments ('review conflict/ambiguous'), so a couple of clauses take a second read, but nothing is redundant.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 10-parameter, nested-object, open-world mutation with an output schema, the description covers trigger, exclusion, required contact handling, retry/recovery, timing bounds, and what the call explicitly does not do. Return values are covered by the output schema, so the remaining omission is not a gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline would be 3; the description earns more by adding cross-field binding rules ('bind submissionId/resumeToken to unchanged ride, contact, locale, offerKey and partner context') and the email-or-E.164 requirement that govern how parameters must be kept consistent across retries. It largely echoes schema-level notes, so it stops short of a 5.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The opening sentence names the specific action (preparing a customer-requested unpaid offer) and ties it to a concrete precondition (offerRequested=true). It immediately names the sibling it is not (quote_ride) so an agent can distinguish offer preparation from pricing without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit when-to-use ('customer-requested unpaid offer'), explicit when-not ('Do not use for prices, use quote_ride instead'), plus routing for the failure path ('Recover with get_offer_status and the original pair') and for throttling/ambiguity ('Wait retryAfterSeconds', 'review conflict/ambiguous'). Alternatives and edge-case handling are named rather than implied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Use this when pricing a complete anonymous Samuelz Chauffeur ride. Do not use for discovery (use get_service_options instead); check terms with get_customer_policy. Keep offerKey across these calls; it determines the local calendar/time zone. Return pickup must follow outbound pickup; hourly service cannot include a return. vehiclePreference and specialRequests share 500 characters, including the added 'Vehicle preference: ' prefix and newline. quoted is no reservation or availability promise; outside_service_area has no price; review_required needs review. No login/contact. Repeats consume the shared REST/MCP budget; wait retryAfterSeconds on rate_limited.
| Name | Required | Description | Default |
|---|---|---|---|
| ride | Yes | Pickup, destination, local date, time and passengers. | |
| locale | No | Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility. | en |
| offerKey | No | Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant. | |
| specialRequests | No | Optional requirements, at most 500 characters. |
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Despite readOnlyHint=true already covering the safety profile, the description adds substantial behavior an agent cannot get from annotations: 'quoted' is not a reservation, outside_service_area carries no price, review_required needs manual review, no login/contact is needed, and repeats draw on a shared REST/MCP budget with retryAfterSeconds on rate_limited. This is exactly the kind of outcome taxonomy and rate-limit disclosure the annotations do not carry.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the selection rule and alternatives before the constraint cluster, and the outcome vocabulary (quoted/outside_service_area/review_required/rate_limited) is packed efficiently. It is dense and semicolon-chained, verging on telegraphic, but no sentence is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
A read-only pricing tool with an output schema, full parameter documentation, and rich annotations is well served here: all call-sequencing constraints, the offerKey carry-over rule, and the meaning of each terminal status are covered, so an agent can call and interpret it correctly in one pass.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema coverage the baseline is 3, and the description climbs above it by adding cross-parameter rules absent from the schema: offerKey must be preserved and determines the local calendar/time zone, return pickup must follow outbound pickup, and hourly service cannot include a return. The shared 500-character budget across vehiclePreference and specialRequests (including the injected prefix and newline) is a genuine constraint the per-field maxLength values do not express.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Opens with a specific verb+resource: pricing a complete anonymous Samuelz Chauffeur ride. It immediately distinguishes itself from discovery siblings by naming get_service_options and get_customer_policy, so an agent can route without opening any schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicit when-to-use ('pricing a complete ride') and when-not-to-use ('Do not use for discovery'), with the correct alternative named for each excluded case plus get_customer_policy for terms. Nothing is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
quote_ride1 field changedOutput schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "This read could not be completed safely.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "locations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "areas": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "id": {
- "type": "string"
- },
- "label": {
- "type": "string"
- }
- },
- "required": [
- "id",
- "label"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "countryCode": {
- "type": "string"
- },
- "key": {
- "type": "string"
- },
- "label": {
- "type": "string"
- },
- "timeZone": {
- "type": "string"
- }
- },
- "required": [
- "key",
- "countryCode",
- "timeZone",
- "label",
- "areas"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "nextAction": {
- "type": "string"
- },
- "reason": {
- "const": "outside_service_area",
- "type": "string"
- },
- "status": {
- "const": "outside_service_area",
- "description": "No price: outside the published areas.",
- "type": "string"
- },
- "timeZone": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "reason",
- "bookingUrl",
- "timeZone",
- "locations",
- "nextAction"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "retryAfterSeconds": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "description": "Quote admission is rate-limited.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "code": {
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "description": "The ride needs review. No price is confirmed.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "type": "string"
- },
- "quote": {
- "additionalProperties": false,
- "properties": {
- "billableHoursPerServiceLine": {
- "exclusiveMinimum": 0,
- "type": "number"
- },
- "calculatedAt": {
- "type": "string"
- },
- "currency": {
- "type": "string"
- },
- "grossTotalCents": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "parkingIncluded": {
- "type": "boolean"
- },
- "pricesIncludeVat": {
- "type": "boolean"
- },
- "revalidationRequired": {
- "const": true,
- "type": "boolean"
- },
- "serviceLines": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "direction": {
- "enum": [
- "outbound",
- "return"
- ],
- "type": "string"
- },
- "grossAmountCents": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "direction",
- "grossAmountCents"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "tollsIncluded": {
- "type": "boolean"
- },
- "vatRateBasisPoints": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "vehicleCount": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "pricesIncludeVat",
- "vatRateBasisPoints",
- "parkingIncluded",
- "tollsIncluded",
- "vehicleCount",
- "billableHoursPerServiceLine",
- "serviceLines",
- "calculatedAt",
- "revalidationRequired"
- ],
- "type": "object"
- },
- "status": {
- "const": "quoted",
- "description": "A price preview. Revalidate before an offer.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "bookingConfirmed",
- "quote",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "This read could not be completed safely.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "locations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "areas": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "label"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "timeZone",
+ "label",
+ "areas"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "reason": {
+ "const": "outside_service_area",
+ "type": "string"
+ },
+ "status": {
+ "const": "outside_service_area",
+ "description": "No price: outside the published areas.",
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "bookingUrl",
+ "timeZone",
+ "locations",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "retryAfterSeconds": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Quote admission is rate-limited.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "code": {
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "The ride needs review. No price is confirmed.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "quote": {
+ "additionalProperties": false,
+ "properties": {
+ "billableHoursPerServiceLine": {
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "calculatedAt": {
+ "type": "string"
+ },
+ "currency": {
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "parkingIncluded": {
+ "type": "boolean"
+ },
+ "pricesIncludeVat": {
+ "type": "boolean"
+ },
+ "pricingBasis": {
+ "enum": [
+ "google_routes",
+ "policy_fallback",
+ "tenant_policy",
+ "server_policy"
+ ],
+ "type": "string"
+ },
+ "pricingMode": {
+ "enum": [
+ "fixed_muc_transfer",
+ "hourly_route",
+ "hourly_home_market"
+ ],
+ "type": "string"
+ },
+ "revalidationRequired": {
+ "const": true,
+ "type": "boolean"
+ },
+ "serviceLines": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "direction": {
+ "enum": [
+ "outbound",
+ "return"
+ ],
+ "type": "string"
+ },
+ "grossAmountCents": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "direction",
+ "grossAmountCents"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "tollsIncluded": {
+ "type": "boolean"
+ },
+ "vatRateBasisPoints": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "vehicleCount": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "pricesIncludeVat",
+ "vatRateBasisPoints",
+ "parkingIncluded",
+ "tollsIncluded",
+ "vehicleCount",
+ "billableHoursPerServiceLine",
+ "serviceLines",
+ "calculatedAt",
+ "revalidationRequired"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "quoted",
+ "description": "A price preview. Revalidate before an offer.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "bookingConfirmed",
+ "quote",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]get_offer_status2 fields changedInput schema / properties / resumeToken / descriptionPrevious value: -"Caller-generated private secret of 64 hexadecimal characters. Generate once, retain it with submissionId for recovery, and never share the pair publicly or replace it on uncertain retries."New value: +"Original private 64-character hexadecimal resumeToken sent with this submissionId. Reuse it unchanged; never generate a replacement. Expired, invalid or foreign-provider proof can return not_found without proving that no booking exists."Input schema / properties / submissionId / descriptionPrevious value: -"Create one UUID for one explicitly requested offer, for example 123e4567-e89b-42d3-a456-426614174000. Retain it with the original resumeToken and unchanged request on retries."New value: +"Original submissionId UUID sent to prepare_offer for this attempt, including when its response was lost. Reuse it with the original resumeToken; do not generate a new ID or substitute a booking ID."get_customer_policy2 fields changedInput schema / properties / locale / descriptionPrevious value: -"Language for text and links: en, or de."New value: +"Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."Input schema / properties / offerKey / descriptionPrevious value: -"Published supplier offer key, not a booking id."New value: +"Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."get_offer_status2 fields changedInput schema / properties / resumeToken / descriptionPrevious value: -"Private 64-hex secret. Keep the original pair."New value: +"Caller-generated private secret of 64 hexadecimal characters. Generate once, retain it with submissionId for recovery, and never share the pair publicly or replace it on uncertain retries."Input schema / properties / submissionId / descriptionPrevious value: -"UUID for one explicit offer. Reuse it on retries."New value: +"Create one UUID for one explicitly requested offer, for example 123e4567-e89b-42d3-a456-426614174000. Retain it with the original resumeToken and unchanged request on retries."get_service_options2 fields changedInput schema / properties / locale / descriptionPrevious value: -"Language for text and links: en, or de."New value: +"Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."Input schema / properties / offerKey / descriptionPrevious value: -"Published supplier offer key, not a booking id."New value: +"Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."prepare_offer8 fields changedInput schema / properties / adsConsentRemoved value: -{
- "description": "Ausdrückliche Einwilligung in Werbemessung; ohne Angabe gilt keine Einwilligung.",
- "enum": [
- "granted",
- "denied"
- ],
- "type": "string"
-}Input schema / properties / locale / descriptionPrevious value: -"Language for text and links: en, or de."New value: +"Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."Input schema / properties / offerKey / descriptionPrevious value: -"Published supplier offer key, not a booking id."New value: +"Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."Input schema / properties / resumeToken / descriptionPrevious value: -"Private 64-hex secret. Keep the original pair."New value: +"Caller-generated private secret of 64 hexadecimal characters. Generate once, retain it with submissionId for recovery, and never share the pair publicly or replace it on uncertain retries."Input schema / properties / ride / properties / date / descriptionPrevious value: -"Service date as YYYY-MM-DD in the provider time zone."New value: +"Service date as YYYY-MM-DD, for example 2026-12-24, in the selected location’s time zone; do not convert it to a UTC date."Input schema / properties / ride / properties / hours / descriptionPrevious value: -"Booked hours for hourly service; omit for transfers."New value: +"Whole service hours from 1 to 24, for example 3. Required only for serviceType=hourly; omit for transfers. Billable hours may differ after price calculation."Input schema / properties / ride / properties / time / descriptionPrevious value: -"Local pickup time as HH:mm in the provider time zone."New value: +"Local pickup time in 24-hour HH:mm format, for example 14:30, in the selected location’s time zone."Input schema / properties / submissionId / descriptionPrevious value: -"UUID for one explicit offer. Reuse it on retries."New value: +"Create one UUID for one explicitly requested offer, for example 123e4567-e89b-42d3-a456-426614174000. Retain it with the original resumeToken and unchanged request on retries."quote_ride5 fields changedInput schema / properties / locale / descriptionPrevious value: -"Language for text and links: en, or de."New value: +"Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."Input schema / properties / offerKey / descriptionPrevious value: -"Published supplier offer key, not a booking id."New value: +"Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."Input schema / properties / ride / properties / date / descriptionPrevious value: -"Service date as YYYY-MM-DD in the provider time zone."New value: +"Service date as YYYY-MM-DD, for example 2026-12-24, in the selected location’s time zone; do not convert it to a UTC date."Input schema / properties / ride / properties / hours / descriptionPrevious value: -"Booked hours for hourly service; omit for transfers."New value: +"Whole service hours from 1 to 24, for example 3. Required only for serviceType=hourly; omit for transfers. Billable hours may differ after price calculation."Input schema / properties / ride / properties / time / descriptionPrevious value: -"Local pickup time as HH:mm in the provider time zone."New value: +"Local pickup time in 24-hour HH:mm format, for example 14:30, in the selected location’s time zone."prepare_offer1 field changedInput schema / properties / adsConsentAdded value: +{
+ "description": "Ausdrückliche Einwilligung in Werbemessung; ohne Angabe gilt keine Einwilligung.",
+ "enum": [
+ "granted",
+ "denied"
+ ],
+ "type": "string"
+}get_customer_policy3 fields changedInput schema / properties / locale / descriptionPrevious value: -"Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."New value: +"Language for text and links: en, or de."Input schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."New value: +"Published supplier offer key, not a booking id."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation's contract; correct the facts before retrying.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "description": "Reading policy does not create or confirm a booking.",
- "type": "boolean"
- },
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "observedAt": {
- "description": "ISO 8601 UTC timestamp when the current minimum-lead-time policy was read, not its expiry or a guarantee of future validity.",
- "type": "string"
- },
- "revalidationRequired": {
- "const": true,
- "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
- "type": "boolean"
- },
- "scope": {
- "const": "booking_preparation",
- "description": "These rules cover preparation of a customer offer/booking, not action authority.",
- "type": "string"
- },
- "status": {
- "const": "available",
- "description": "Current booking-preparation policy was read; no booking is confirmed.",
- "type": "string"
- },
- "terms": {
- "additionalProperties": false,
- "description": "Current published account, guest-booking, lead-time and confirmation rules.",
- "properties": {
- "accountRequired": {
- "description": "Whether current purchase policy requires an account.",
- "type": "boolean"
- },
- "bookerForGuestAllowed": {
- "description": "Whether current policy allows a booker to request service for another guest.",
- "type": "boolean"
- },
- "bookingConfirmation": {
- "const": "after_confirmed_full_payment",
- "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
- "type": "string"
- },
- "minimumLeadTimeMinutes": {
- "description": "Current minimum time before pickup, expressed in minutes.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "serviceSpecificTerms": {
- "const": "review_the_current_offer_before_confirmation",
- "description": "Review the complete terms bound to the current offer before confirming.",
- "type": "string"
- }
- },
- "required": [
- "minimumLeadTimeMinutes",
- "accountRequired",
- "bookerForGuestAllowed",
- "bookingConfirmation",
- "serviceSpecificTerms"
- ],
- "type": "object"
- },
- "timeZone": {
- "description": "Configured local time zone for the selected provider/service location.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "timeZone",
- "observedAt",
- "scope",
- "revalidationRequired",
- "terms",
- "bookingConfirmed"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "This read could not be completed safely.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "observedAt": {
+ "type": "string"
+ },
+ "revalidationRequired": {
+ "const": true,
+ "type": "boolean"
+ },
+ "scope": {
+ "const": "booking_preparation",
+ "type": "string"
+ },
+ "status": {
+ "const": "available",
+ "description": "Current booking terms were read.",
+ "type": "string"
+ },
+ "terms": {
+ "additionalProperties": false,
+ "properties": {
+ "accountRequired": {
+ "type": "boolean"
+ },
+ "bookerForGuestAllowed": {
+ "type": "boolean"
+ },
+ "bookingConfirmation": {
+ "const": "after_confirmed_full_payment",
+ "type": "string"
+ },
+ "minimumLeadTimeMinutes": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "serviceSpecificTerms": {
+ "const": "review_the_current_offer_before_confirmation",
+ "type": "string"
+ }
+ },
+ "required": [
+ "minimumLeadTimeMinutes",
+ "accountRequired",
+ "bookerForGuestAllowed",
+ "bookingConfirmation",
+ "serviceSpecificTerms"
+ ],
+ "type": "object"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "timeZone",
+ "observedAt",
+ "scope",
+ "revalidationRequired",
+ "terms",
+ "bookingConfirmed"
+ ],
+ "type": "object"
+ }
+]get_offer_status3 fields changedInput schema / properties / resumeToken / descriptionPrevious value: -"Caller-generated private 64-character hexadecimal secret for this submission (32 random bytes). Keep its original submissionId pair. The stored resume proof expires 24 hours after first claimed intake; unchanged retries do not renew it. This is separate from offer.expiresAt and is not an account credential."New value: +"Private 64-hex secret. Keep the original pair."Input schema / properties / submissionId / descriptionPrevious value: -"Caller-generated UUID for one explicitly requested offer intent. Keep the same submissionId/resumeToken and unchanged facts for retries and status; a new explicit intent needs a new pair. This is not a bookingKey."New value: +"UUID for one explicit offer. Reuse it on retries."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation's contract; correct the facts before retrying.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "description": "Wait at least this many seconds, then use the same original submissionId/resumeToken pair for status or unchanged retry.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "pending",
- "description": "The original offer-intent execution is still pending; no completed offer result is available.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "description": "Wait at least this many seconds before retrying the unchanged submissionId/resumeToken and facts.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "description": "Offer preparation admission was rate-limited; retry only the unchanged explicit offer intent.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "description": "conflict means stored intent/offer facts disagree; ambiguous means execution or bound evidence cannot safely be resolved; not_found denies access to the original submission proof. Inspect status rather than blindly creating another offer.",
- "enum": [
- "conflict",
- "ambiguous",
- "not_found"
- ],
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "booking": {
- "additionalProperties": false,
- "description": "Booking state read from the stored reservation; it may lag provider events.",
- "properties": {
- "recordedStatus": {
- "description": "Stored reservation status string. It is not a new provider confirmation.",
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "bookingKey": {
- "description": "Internal reservation ID for this selected booking. Returned in the available branch of get_offer_status/prepare_offer or an authorized booking read, not in prepared. It grants no access by itself.",
- "maxLength": 128,
- "minLength": 1,
- "type": "string"
- },
- "bookingReference": {
- "description": "Stored customer-visible reservation reference, falling back to bookingKey when absent. Customer OAuth accepts it only for its already-selected booking; it is not the supplier offerKey.",
- "minLength": 1,
- "type": "string"
- },
- "customerPortalUrl": {
- "description": "Private customer-login entry for the original submission proof. This available branch also returns this booking's ID/reference; no history or write authority is granted.",
- "format": "uri",
- "type": "string"
- },
- "fulfillment": {
- "additionalProperties": false,
- "description": "Flags derived from stored assignments and status, not live fulfillment confirmation.",
- "properties": {
- "chauffeurAssignmentRecorded": {
- "description": "True when a chauffeur ID is stored on the reservation; it does not confirm dispatch or acceptance.",
- "type": "boolean"
- },
- "completionRecorded": {
- "description": "True only when the stored reservation status is completed; no fresh service-completion check is made.",
- "type": "boolean"
- },
- "vehicleAssignmentRecorded": {
- "description": "True when a vehicle ID is stored on the reservation; it does not confirm availability or execution.",
- "type": "boolean"
- }
- },
- "required": [
- "chauffeurAssignmentRecorded",
- "vehicleAssignmentRecorded",
- "completionRecorded"
- ],
- "type": "object"
- },
- "payment": {
- "additionalProperties": false,
- "description": "Recorded payment state from this booking, without a payment-provider refresh.",
- "properties": {
- "recordedStatus": {
- "description": "Stored reservation payment-status string; no payment or refund is initiated or newly confirmed.",
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "status": {
- "const": "available",
- "description": "The selected booking was accessible and its stored fields passed validation; no provider refresh occurred.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingKey",
- "bookingReference",
- "booking",
- "payment",
- "fulfillment",
- "customerPortalUrl"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "message": {
- "description": "Customer-language explanation of the required review.",
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "description": "Structured reason and safe next step for requirements review.",
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "description": "This review result does not confirm availability.",
- "type": "boolean"
- },
- "code": {
- "description": "Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.",
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "description": "No customer contact is required for this price/requirements review.",
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "description": "Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "description": "Offer preparation requires review of the ride facts/requirements; availability is not confirmed.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message",
- "review"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "expired",
- "description": "The existing bound offer has expired; this does not extend or describe the separate resume-proof lifetime.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "description": "Offer preparation does not confirm a booking or charge the customer.",
- "type": "boolean"
- },
- "checkoutUrl": {
- "description": "Private bound offer-review page to review complete terms and explicitly confirm using the existing flow. Treat this offer link as private.",
- "format": "uri",
- "type": "string"
- },
- "customerPortalUrl": {
- "description": "Existing private customer-login entry with the original submissionId/resumeToken in its fragment. Keep it private; current session/proof authority is still required.",
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "description": "Guidance to open checkoutUrl, review the bound terms and explicitly confirm; no confirmation occurred in this call.",
- "type": "string"
- },
- "offer": {
- "additionalProperties": false,
- "description": "Existing offer amount, expiry and confirmation/terms requirements.",
- "properties": {
- "completeTermsBound": {
- "const": true,
- "description": "Complete service/legal terms were verified as bound to this offer.",
- "type": "boolean"
- },
- "currency": {
- "const": "EUR",
- "description": "Currency of the bound offer: EUR.",
- "type": "string"
- },
- "customerConfirmationRequired": {
- "const": true,
- "description": "The customer must explicitly review and confirm the offer on its page.",
- "type": "boolean"
- },
- "expiresAt": {
- "description": "Stored offer expiry timestamp from offer_expires_at. Separate from the 24-hour submission resume-proof lifetime; re-review an expired or revised offer.",
- "type": "string"
- },
- "grossTotalCents": {
- "description": "Bound offer gross total in EUR cents, including applicable tax.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "expiresAt",
- "customerConfirmationRequired",
- "completeTermsBound"
- ],
- "type": "object"
- },
- "status": {
- "const": "prepared",
- "description": "The existing unpaid draft and its bound offer links are ready for customer review; this branch does not return bookingKey/bookingReference.",
- "type": "string"
- },
- "termsUrl": {
- "description": "The same offer page with complete bound service/legal terms.",
- "format": "uri",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingConfirmed",
- "checkoutUrl",
- "termsUrl",
- "offer",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "This read could not be completed safely.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "locations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "areas": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "label"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "timeZone",
+ "label",
+ "areas"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "reason": {
+ "const": "outside_service_area",
+ "type": "string"
+ },
+ "status": {
+ "const": "outside_service_area",
+ "description": "No price: outside the published areas.",
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "bookingUrl",
+ "timeZone",
+ "locations",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "pending",
+ "description": "This offer intent is still pending.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Offer admission is rate-limited.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "description": "conflict, ambiguous, or not_found. Do not create another offer.",
+ "enum": [
+ "conflict",
+ "ambiguous",
+ "not_found"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "booking": {
+ "additionalProperties": false,
+ "properties": {
+ "recordedStatus": {
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "bookingKey": {
+ "maxLength": 128,
+ "minLength": 1,
+ "type": "string"
+ },
+ "bookingReference": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "fulfillment": {
+ "additionalProperties": false,
+ "properties": {
+ "chauffeurAssignmentRecorded": {
+ "type": "boolean"
+ },
+ "completionRecorded": {
+ "type": "boolean"
+ },
+ "vehicleAssignmentRecorded": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "chauffeurAssignmentRecorded",
+ "vehicleAssignmentRecorded",
+ "completionRecorded"
+ ],
+ "type": "object"
+ },
+ "payment": {
+ "additionalProperties": false,
+ "properties": {
+ "recordedStatus": {
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "available",
+ "description": "Stored booking fields passed validation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingKey",
+ "bookingReference",
+ "booking",
+ "payment",
+ "fulfillment",
+ "customerPortalUrl"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "code": {
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "Offer preparation needs review.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message",
+ "review"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "expired",
+ "description": "The bound offer has expired.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "checkoutUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "offer": {
+ "additionalProperties": false,
+ "properties": {
+ "completeTermsBound": {
+ "const": true,
+ "type": "boolean"
+ },
+ "currency": {
+ "const": "EUR",
+ "type": "string"
+ },
+ "customerConfirmationRequired": {
+ "const": true,
+ "type": "boolean"
+ },
+ "expiresAt": {
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "expiresAt",
+ "customerConfirmationRequired",
+ "completeTermsBound"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "prepared",
+ "description": "Unpaid offer links are ready for review.",
+ "type": "string"
+ },
+ "termsUrl": {
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingConfirmed",
+ "checkoutUrl",
+ "termsUrl",
+ "offer",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]get_service_options3 fields changedInput schema / properties / locale / descriptionPrevious value: -"Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."New value: +"Language for text and links: en, or de."Input schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."New value: +"Published supplier offer key, not a booking id."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation's contract; correct the facts before retrying.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "hourlyRideFacts": {
- "description": "Additional hourly-service fields and required service/trip-type values.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "location": {
- "additionalProperties": false,
- "description": "Location configured for the supplied published offerKey; omitted for the default service scope.",
- "properties": {
- "countryCode": {
- "description": "Country code configured for this service location.",
- "type": "string"
- },
- "key": {
- "description": "Configured service-location key selected by the published supplier offerKey.",
- "type": "string"
- },
- "label": {
- "description": "Location label in the requested language.",
- "type": "string"
- }
- },
- "required": [
- "key",
- "countryCode",
- "label"
- ],
- "type": "object"
- },
- "nextAction": {
- "description": "Guidance to collect complete ride facts and request a price preview; no contact details are required for quoting.",
- "type": "string"
- },
- "provider": {
- "description": "Published display name of the service provider.",
- "type": "string"
- },
- "requiredRideFacts": {
- "description": "Ride fields to collect before quoting a transfer.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "returnRideFacts": {
- "description": "Additional return-trip fields to collect for an outbound and later return pickup.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "services": {
- "description": "Published service definitions and supported trip types.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "availability": {
- "const": "requires_offer_review",
- "description": "Availability/acceptance still require review of an actual offer.",
- "type": "string"
- },
- "key": {
- "description": "Published service identifier, such as transfer or hourly service.",
- "type": "string"
- },
- "tripTypes": {
- "description": "Trip types supported by this service definition; not confirmed availability.",
- "items": {
- "enum": [
- "one_way",
- "return"
- ],
- "type": "string"
- },
- "type": "array"
- }
- },
- "required": [
- "key",
- "tripTypes",
- "availability"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "status": {
- "const": "available",
- "description": "Published service information is readable; no price, acceptance or availability is confirmed.",
- "type": "string"
- },
- "timeZone": {
- "description": "Configured local provider time zone for ride dates and pickup times.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "provider",
- "timeZone",
- "bookingUrl",
- "services",
- "requiredRideFacts",
- "returnRideFacts",
- "hourlyRideFacts",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "This read could not be completed safely.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "hourlyRideFacts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "languages": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "location": {
+ "additionalProperties": false,
+ "properties": {
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "label"
+ ],
+ "type": "object"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "provider": {
+ "type": "string"
+ },
+ "requiredRideFacts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "returnRideFacts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "serviceAreas": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "areas": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "label"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "timeZone",
+ "label",
+ "areas"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "services": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "availability": {
+ "const": "requires_offer_review",
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "tripTypes": {
+ "items": {
+ "enum": [
+ "one_way",
+ "return"
+ ],
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "key",
+ "tripTypes",
+ "availability"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "const": "available",
+ "description": "Published services are readable.",
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "provider",
+ "timeZone",
+ "bookingUrl",
+ "services",
+ "languages",
+ "requiredRideFacts",
+ "returnRideFacts",
+ "hourlyRideFacts",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]prepare_offer27 fields changedInput schema / properties / contact / descriptionPrevious value: -"Customer/booker contact for this explicitly requested offer: email OR E.164 phone is required. Contact does not authorize private booking/history access."New value: +"Customer email or phone for this requested offer."Input schema / properties / contact / properties / email / descriptionPrevious value: -"Reachable customer/booker email, at most 254 characters; required if no phone is supplied."New value: +"Customer email, required when no phone is given."Input schema / properties / contact / properties / fullName / descriptionPrevious value: -"Optional customer/booker full name, 2–120 characters."New value: +"Optional customer name, 2 to 120 characters."Input schema / properties / contact / properties / phone / descriptionPrevious value: -"Reachable international E.164 phone, + followed by 7–15 digits, no spaces; required if no email is supplied."New value: +"E.164 phone, required when no email is given."Input schema / properties / distributionPartnerCapability / descriptionPrevious value: -"Optional existing opaque dp_live_ capability issued to an approved distribution partner. Omit for normal customers; do not create or guess one."New value: +"Existing dp_live_ partner token. Omit for customers."Input schema / properties / firstTouchTrackingToken / descriptionPrevious value: -"Optional existing server-issued first-touch UUID token for this tenant and consented attribution. Omit if none; never invent a token or source."New value: +"Existing first-touch token. Never invent one."Input schema / properties / locale / descriptionPrevious value: -"Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."New value: +"Language for text and links: en, or de."Input schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."New value: +"Published supplier offer key, not a booking id."Input schema / properties / offerRequested / descriptionPrevious value: -"Must be true only after the customer explicitly requests an offer; a price question alone is insufficient consent."New value: +"True only after the customer explicitly asks for an offer."Input schema / properties / resumeToken / descriptionPrevious value: -"Caller-generated private 64-character hexadecimal secret for this submission (32 random bytes). Keep its original submissionId pair. The stored resume proof expires 24 hours after first claimed intake; unchanged retries do not renew it. This is separate from offer.expiresAt and is not an account credential."New value: +"Private 64-hex secret. Keep the original pair."Input schema / properties / ride / descriptionPrevious value: -"Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours."New value: +"Pickup, destination, local date, time and passengers."Input schema / properties / ride / properties / date / descriptionPrevious value: -"Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first."New value: +"Service date as YYYY-MM-DD in the provider time zone."Input schema / properties / ride / properties / destination / descriptionPrevious value: -"Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed."New value: +"Destination with city or postcode, distinct from pickup."Input schema / properties / ride / properties / flightNumber / descriptionPrevious value: -"Flight number for an airport pickup, such as LH123; omit when not applicable."New value: +"Flight number for an airport pickup, if known."Input schema / properties / ride / properties / hours / descriptionPrevious value: -"Booked duration for hourly service; omit for transfers."New value: +"Booked hours for hourly service; omit for transfers."Input schema / properties / ride / properties / luggage / descriptionPrevious value: -"Luggage count/type or fit requirements; unusual luggage may require review."New value: +"Luggage notes. Unusual items may need review."Input schema / properties / ride / properties / passengers / descriptionPrevious value: -"Total people travelling; determines vehicle requirements, not availability or acceptance."New value: +"Number of people travelling, from 1 to 60."Input schema / properties / ride / properties / pickup / descriptionPrevious value: -"Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen."New value: +"Pickup place with city or postcode, inside a served area."Input schema / properties / ride / properties / returnDate / descriptionPrevious value: -"Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup."New value: +"Return date YYYY-MM-DD, only for a return trip."Input schema / properties / ride / properties / returnTime / descriptionPrevious value: -"Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips."New value: +"Return time HH:mm, only for a return trip."Input schema / properties / ride / properties / serviceType / descriptionPrevious value: -"Set hourly for service booked by duration; omit for transfers."New value: +"Set hourly for duration service; omit for transfers."Input schema / properties / ride / properties / time / descriptionPrevious value: -"Local pickup time in 24-hour HH:mm format, in the configured timeZone returned by get_service_options for the same offerKey; not UTC or an offset timestamp."New value: +"Local pickup time as HH:mm in the provider time zone."Input schema / properties / ride / properties / tripType / descriptionPrevious value: -"one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer."New value: +"one_way, or return with a later pickup."Input schema / properties / ride / properties / vehiclePreference / descriptionPrevious value: -"Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review."New value: +"Optional vehicle wish, without a price guarantee."Input schema / properties / specialRequests / descriptionPrevious value: -"Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote."New value: +"Optional requirements, at most 500 characters."Input schema / properties / submissionId / descriptionPrevious value: -"Caller-generated UUID for one explicitly requested offer intent. Keep the same submissionId/resumeToken and unchanged facts for retries and status; a new explicit intent needs a new pair. This is not a bookingKey."New value: +"UUID for one explicit offer. Reuse it on retries."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation's contract; correct the facts before retrying.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "description": "Wait at least this many seconds, then use the same original submissionId/resumeToken pair for status or unchanged retry.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "pending",
- "description": "The original offer-intent execution is still pending; no completed offer result is available.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "description": "Wait at least this many seconds before retrying the unchanged submissionId/resumeToken and facts.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "description": "Offer preparation admission was rate-limited; retry only the unchanged explicit offer intent.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "description": "conflict means stored intent/offer facts disagree; ambiguous means execution or bound evidence cannot safely be resolved; not_found denies access to the original submission proof. Inspect status rather than blindly creating another offer.",
- "enum": [
- "conflict",
- "ambiguous",
- "not_found"
- ],
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "booking": {
- "additionalProperties": false,
- "description": "Booking state read from the stored reservation; it may lag provider events.",
- "properties": {
- "recordedStatus": {
- "description": "Stored reservation status string. It is not a new provider confirmation.",
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "bookingKey": {
- "description": "Internal reservation ID for this selected booking. Returned in the available branch of get_offer_status/prepare_offer or an authorized booking read, not in prepared. It grants no access by itself.",
- "maxLength": 128,
- "minLength": 1,
- "type": "string"
- },
- "bookingReference": {
- "description": "Stored customer-visible reservation reference, falling back to bookingKey when absent. Customer OAuth accepts it only for its already-selected booking; it is not the supplier offerKey.",
- "minLength": 1,
- "type": "string"
- },
- "customerPortalUrl": {
- "description": "Private customer-login entry for the original submission proof. This available branch also returns this booking's ID/reference; no history or write authority is granted.",
- "format": "uri",
- "type": "string"
- },
- "fulfillment": {
- "additionalProperties": false,
- "description": "Flags derived from stored assignments and status, not live fulfillment confirmation.",
- "properties": {
- "chauffeurAssignmentRecorded": {
- "description": "True when a chauffeur ID is stored on the reservation; it does not confirm dispatch or acceptance.",
- "type": "boolean"
- },
- "completionRecorded": {
- "description": "True only when the stored reservation status is completed; no fresh service-completion check is made.",
- "type": "boolean"
- },
- "vehicleAssignmentRecorded": {
- "description": "True when a vehicle ID is stored on the reservation; it does not confirm availability or execution.",
- "type": "boolean"
- }
- },
- "required": [
- "chauffeurAssignmentRecorded",
- "vehicleAssignmentRecorded",
- "completionRecorded"
- ],
- "type": "object"
- },
- "payment": {
- "additionalProperties": false,
- "description": "Recorded payment state from this booking, without a payment-provider refresh.",
- "properties": {
- "recordedStatus": {
- "description": "Stored reservation payment-status string; no payment or refund is initiated or newly confirmed.",
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "status": {
- "const": "available",
- "description": "The selected booking was accessible and its stored fields passed validation; no provider refresh occurred.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingKey",
- "bookingReference",
- "booking",
- "payment",
- "fulfillment",
- "customerPortalUrl"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "message": {
- "description": "Customer-language explanation of the required review.",
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "description": "Structured reason and safe next step for requirements review.",
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "description": "This review result does not confirm availability.",
- "type": "boolean"
- },
- "code": {
- "description": "Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.",
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "description": "No customer contact is required for this price/requirements review.",
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "description": "Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "description": "Offer preparation requires review of the ride facts/requirements; availability is not confirmed.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message",
- "review"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "expired",
- "description": "The existing bound offer has expired; this does not extend or describe the separate resume-proof lifetime.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "description": "Offer preparation does not confirm a booking or charge the customer.",
- "type": "boolean"
- },
- "checkoutUrl": {
- "description": "Private bound offer-review page to review complete terms and explicitly confirm using the existing flow. Treat this offer link as private.",
- "format": "uri",
- "type": "string"
- },
- "customerPortalUrl": {
- "description": "Existing private customer-login entry with the original submissionId/resumeToken in its fragment. Keep it private; current session/proof authority is still required.",
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "description": "Guidance to open checkoutUrl, review the bound terms and explicitly confirm; no confirmation occurred in this call.",
- "type": "string"
- },
- "offer": {
- "additionalProperties": false,
- "description": "Existing offer amount, expiry and confirmation/terms requirements.",
- "properties": {
- "completeTermsBound": {
- "const": true,
- "description": "Complete service/legal terms were verified as bound to this offer.",
- "type": "boolean"
- },
- "currency": {
- "const": "EUR",
- "description": "Currency of the bound offer: EUR.",
- "type": "string"
- },
- "customerConfirmationRequired": {
- "const": true,
- "description": "The customer must explicitly review and confirm the offer on its page.",
- "type": "boolean"
- },
- "expiresAt": {
- "description": "Stored offer expiry timestamp from offer_expires_at. Separate from the 24-hour submission resume-proof lifetime; re-review an expired or revised offer.",
- "type": "string"
- },
- "grossTotalCents": {
- "description": "Bound offer gross total in EUR cents, including applicable tax.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "expiresAt",
- "customerConfirmationRequired",
- "completeTermsBound"
- ],
- "type": "object"
- },
- "status": {
- "const": "prepared",
- "description": "The existing unpaid draft and its bound offer links are ready for customer review; this branch does not return bookingKey/bookingReference.",
- "type": "string"
- },
- "termsUrl": {
- "description": "The same offer page with complete bound service/legal terms.",
- "format": "uri",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingConfirmed",
- "checkoutUrl",
- "termsUrl",
- "offer",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "This read could not be completed safely.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "locations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "areas": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "label"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "timeZone",
+ "label",
+ "areas"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "reason": {
+ "const": "outside_service_area",
+ "type": "string"
+ },
+ "status": {
+ "const": "outside_service_area",
+ "description": "No price: outside the published areas.",
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "bookingUrl",
+ "timeZone",
+ "locations",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "pending",
+ "description": "This offer intent is still pending.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Offer admission is rate-limited.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "description": "conflict, ambiguous, or not_found. Do not create another offer.",
+ "enum": [
+ "conflict",
+ "ambiguous",
+ "not_found"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "booking": {
+ "additionalProperties": false,
+ "properties": {
+ "recordedStatus": {
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "bookingKey": {
+ "maxLength": 128,
+ "minLength": 1,
+ "type": "string"
+ },
+ "bookingReference": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "fulfillment": {
+ "additionalProperties": false,
+ "properties": {
+ "chauffeurAssignmentRecorded": {
+ "type": "boolean"
+ },
+ "completionRecorded": {
+ "type": "boolean"
+ },
+ "vehicleAssignmentRecorded": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "chauffeurAssignmentRecorded",
+ "vehicleAssignmentRecorded",
+ "completionRecorded"
+ ],
+ "type": "object"
+ },
+ "payment": {
+ "additionalProperties": false,
+ "properties": {
+ "recordedStatus": {
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "available",
+ "description": "Stored booking fields passed validation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingKey",
+ "bookingReference",
+ "booking",
+ "payment",
+ "fulfillment",
+ "customerPortalUrl"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "code": {
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "Offer preparation needs review.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message",
+ "review"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "expired",
+ "description": "The bound offer has expired.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "checkoutUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "offer": {
+ "additionalProperties": false,
+ "properties": {
+ "completeTermsBound": {
+ "const": true,
+ "type": "boolean"
+ },
+ "currency": {
+ "const": "EUR",
+ "type": "string"
+ },
+ "customerConfirmationRequired": {
+ "const": true,
+ "type": "boolean"
+ },
+ "expiresAt": {
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "expiresAt",
+ "customerConfirmationRequired",
+ "completeTermsBound"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "prepared",
+ "description": "Unpaid offer links are ready for review.",
+ "type": "string"
+ },
+ "termsUrl": {
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingConfirmed",
+ "checkoutUrl",
+ "termsUrl",
+ "offer",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]quote_ride18 fields changedInput schema / properties / locale / descriptionPrevious value: -"Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."New value: +"Language for text and links: en, or de."Input schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."New value: +"Published supplier offer key, not a booking id."Input schema / properties / ride / descriptionPrevious value: -"Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours."New value: +"Pickup, destination, local date, time and passengers."Input schema / properties / ride / properties / date / descriptionPrevious value: -"Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first."New value: +"Service date as YYYY-MM-DD in the provider time zone."Input schema / properties / ride / properties / destination / descriptionPrevious value: -"Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed."New value: +"Destination with city or postcode, distinct from pickup."Input schema / properties / ride / properties / flightNumber / descriptionPrevious value: -"Flight number for an airport pickup, such as LH123; omit when not applicable."New value: +"Flight number for an airport pickup, if known."Input schema / properties / ride / properties / hours / descriptionPrevious value: -"Booked duration for hourly service; omit for transfers."New value: +"Booked hours for hourly service; omit for transfers."Input schema / properties / ride / properties / luggage / descriptionPrevious value: -"Luggage count/type or fit requirements; unusual luggage may require review."New value: +"Luggage notes. Unusual items may need review."Input schema / properties / ride / properties / passengers / descriptionPrevious value: -"Total people travelling; determines vehicle requirements, not availability or acceptance."New value: +"Number of people travelling, from 1 to 60."Input schema / properties / ride / properties / pickup / descriptionPrevious value: -"Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen."New value: +"Pickup place with city or postcode, inside a served area."Input schema / properties / ride / properties / returnDate / descriptionPrevious value: -"Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup."New value: +"Return date YYYY-MM-DD, only for a return trip."Input schema / properties / ride / properties / returnTime / descriptionPrevious value: -"Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips."New value: +"Return time HH:mm, only for a return trip."Input schema / properties / ride / properties / serviceType / descriptionPrevious value: -"Set hourly for service booked by duration; omit for transfers."New value: +"Set hourly for duration service; omit for transfers."Input schema / properties / ride / properties / time / descriptionPrevious value: -"Local pickup time in 24-hour HH:mm format, in the configured timeZone returned by get_service_options for the same offerKey; not UTC or an offset timestamp."New value: +"Local pickup time as HH:mm in the provider time zone."Input schema / properties / ride / properties / tripType / descriptionPrevious value: -"one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer."New value: +"one_way, or return with a later pickup."Input schema / properties / ride / properties / vehiclePreference / descriptionPrevious value: -"Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review."New value: +"Optional vehicle wish, without a price guarantee."Input schema / properties / specialRequests / descriptionPrevious value: -"Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote."New value: +"Optional requirements, at most 500 characters."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation's contract; correct the facts before retrying.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "retryAfterSeconds": {
- "description": "Wait at least this many seconds before retrying the same quote request.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "description": "Quote admission is currently rate-limited; no quote was returned.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "message": {
- "description": "Customer-language explanation of the required review.",
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "description": "Structured review reason and next step when supplied; not an availability confirmation.",
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "description": "This review result does not confirm availability.",
- "type": "boolean"
- },
- "code": {
- "description": "Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.",
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "description": "No customer contact is required for this price/requirements review.",
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "description": "Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "description": "The ride facts or requirements require further review; no availability conclusion is made.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "description": "A quote does not confirm or create a booking.",
- "type": "boolean"
- },
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "description": "Guidance to proceed only to an explicitly requested offer after reviewing the preview.",
- "type": "string"
- },
- "quote": {
- "additionalProperties": false,
- "description": "Calculated price preview and tax/inclusion breakdown; no reservation or availability confirmation.",
- "properties": {
- "billableHoursPerServiceLine": {
- "description": "Billable hours used for each calculated service line.",
- "exclusiveMinimum": 0,
- "type": "number"
- },
- "calculatedAt": {
- "description": "Timestamp of this preview calculation, not a guaranteed price-validity window.",
- "type": "string"
- },
- "currency": {
- "description": "Currency of the price preview.",
- "type": "string"
- },
- "grossTotalCents": {
- "description": "Gross total of the preview in the returned currency's minor units (EUR cents).",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "parkingIncluded": {
- "description": "Whether parking costs are included in the preview.",
- "type": "boolean"
- },
- "pricesIncludeVat": {
- "description": "Whether the returned price includes VAT.",
- "type": "boolean"
- },
- "revalidationRequired": {
- "const": true,
- "description": "Revalidate price and terms before preparing or confirming an offer.",
- "type": "boolean"
- },
- "serviceLines": {
- "description": "Price breakdown by outbound/return service line.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "direction": {
- "description": "The outbound or return leg priced by this service line.",
- "enum": [
- "outbound",
- "return"
- ],
- "type": "string"
- },
- "grossAmountCents": {
- "description": "Gross price for this service line in the returned currency's minor units.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "direction",
- "grossAmountCents"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "tollsIncluded": {
- "description": "Whether toll costs are included in the preview.",
- "type": "boolean"
- },
- "vatRateBasisPoints": {
- "description": "VAT rate in basis points: 10000 basis points equal 100 percent.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "vehicleCount": {
- "description": "Vehicle count used in this price calculation, not confirmed vehicle availability.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "pricesIncludeVat",
- "vatRateBasisPoints",
- "parkingIncluded",
- "tollsIncluded",
- "vehicleCount",
- "billableHoursPerServiceLine",
- "serviceLines",
- "calculatedAt",
- "revalidationRequired"
- ],
- "type": "object"
- },
- "status": {
- "const": "quoted",
- "description": "A price preview was calculated; it must be revalidated before an actual offer.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "bookingConfirmed",
- "quote",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "This read could not be completed safely.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "locations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "areas": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "label"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "timeZone",
+ "label",
+ "areas"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "reason": {
+ "const": "outside_service_area",
+ "type": "string"
+ },
+ "status": {
+ "const": "outside_service_area",
+ "description": "No price: outside the published areas.",
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "bookingUrl",
+ "timeZone",
+ "locations",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "retryAfterSeconds": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Quote admission is rate-limited.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "code": {
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "The ride needs review. No price is confirmed.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "type": "boolean"
+ },
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "quote": {
+ "additionalProperties": false,
+ "properties": {
+ "billableHoursPerServiceLine": {
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "calculatedAt": {
+ "type": "string"
+ },
+ "currency": {
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "parkingIncluded": {
+ "type": "boolean"
+ },
+ "pricesIncludeVat": {
+ "type": "boolean"
+ },
+ "revalidationRequired": {
+ "const": true,
+ "type": "boolean"
+ },
+ "serviceLines": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "direction": {
+ "enum": [
+ "outbound",
+ "return"
+ ],
+ "type": "string"
+ },
+ "grossAmountCents": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "direction",
+ "grossAmountCents"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "tollsIncluded": {
+ "type": "boolean"
+ },
+ "vatRateBasisPoints": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "vehicleCount": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "pricesIncludeVat",
+ "vatRateBasisPoints",
+ "parkingIncluded",
+ "tollsIncluded",
+ "vehicleCount",
+ "billableHoursPerServiceLine",
+ "serviceLines",
+ "calculatedAt",
+ "revalidationRequired"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "quoted",
+ "description": "A price preview. Revalidate before an offer.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "bookingConfirmed",
+ "quote",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]prepare_offer1 field changedInput schema / properties / ride / properties / time / descriptionPrevious value: -"Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp."New value: +"Local pickup time in 24-hour HH:mm format, in the configured timeZone returned by get_service_options for the same offerKey; not UTC or an offset timestamp."quote_ride1 field changedInput schema / properties / ride / properties / time / descriptionPrevious value: -"Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp."New value: +"Local pickup time in 24-hour HH:mm format, in the configured timeZone returned by get_service_options for the same offerKey; not UTC or an offset timestamp."get_customer_policy1 field changedOutput schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "description": "Input does not match this operation's contract; correct the facts before retrying.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "description": "Reading policy does not create or confirm a booking.",
- "type": "boolean"
- },
- "bookingUrl": {
- "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
- "format": "uri",
- "type": "string"
- },
- "observedAt": {
- "description": "Observation timestamp of the minimum-lead-time policy read; no validity window is promised.",
- "type": "string"
- },
- "revalidationRequired": {
- "const": true,
- "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
- "type": "boolean"
- },
- "scope": {
- "const": "booking_preparation",
- "description": "These rules cover preparation of a customer offer/booking, not action authority.",
- "type": "string"
- },
- "status": {
- "const": "available",
- "description": "Current booking-preparation policy was read; no booking is confirmed.",
- "type": "string"
- },
- "terms": {
- "additionalProperties": false,
- "description": "Current published account, guest-booking, lead-time and confirmation rules.",
- "properties": {
- "accountRequired": {
- "description": "Whether current purchase policy requires an account.",
- "type": "boolean"
- },
- "bookerForGuestAllowed": {
- "description": "Whether current policy allows a booker to request service for another guest.",
- "type": "boolean"
- },
- "bookingConfirmation": {
- "const": "after_confirmed_full_payment",
- "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
- "type": "string"
- },
- "minimumLeadTimeMinutes": {
- "description": "Current minimum time before pickup, expressed in minutes.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "serviceSpecificTerms": {
- "const": "review_the_current_offer_before_confirmation",
- "description": "Review the complete terms bound to the current offer before confirming.",
- "type": "string"
- }
- },
- "required": [
- "minimumLeadTimeMinutes",
- "accountRequired",
- "bookerForGuestAllowed",
- "bookingConfirmation",
- "serviceSpecificTerms"
- ],
- "type": "object"
- },
- "timeZone": {
- "description": "Configured local time zone for the selected provider/service location.",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "timeZone",
- "observedAt",
- "scope",
- "revalidationRequired",
- "terms",
- "bookingConfirmed"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation's contract; correct the facts before retrying.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "description": "Reading policy does not create or confirm a booking.",
+ "type": "boolean"
+ },
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "observedAt": {
+ "description": "ISO 8601 UTC timestamp when the current minimum-lead-time policy was read, not its expiry or a guarantee of future validity.",
+ "type": "string"
+ },
+ "revalidationRequired": {
+ "const": true,
+ "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
+ "type": "boolean"
+ },
+ "scope": {
+ "const": "booking_preparation",
+ "description": "These rules cover preparation of a customer offer/booking, not action authority.",
+ "type": "string"
+ },
+ "status": {
+ "const": "available",
+ "description": "Current booking-preparation policy was read; no booking is confirmed.",
+ "type": "string"
+ },
+ "terms": {
+ "additionalProperties": false,
+ "description": "Current published account, guest-booking, lead-time and confirmation rules.",
+ "properties": {
+ "accountRequired": {
+ "description": "Whether current purchase policy requires an account.",
+ "type": "boolean"
+ },
+ "bookerForGuestAllowed": {
+ "description": "Whether current policy allows a booker to request service for another guest.",
+ "type": "boolean"
+ },
+ "bookingConfirmation": {
+ "const": "after_confirmed_full_payment",
+ "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
+ "type": "string"
+ },
+ "minimumLeadTimeMinutes": {
+ "description": "Current minimum time before pickup, expressed in minutes.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "serviceSpecificTerms": {
+ "const": "review_the_current_offer_before_confirmation",
+ "description": "Review the complete terms bound to the current offer before confirming.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "minimumLeadTimeMinutes",
+ "accountRequired",
+ "bookerForGuestAllowed",
+ "bookingConfirmation",
+ "serviceSpecificTerms"
+ ],
+ "type": "object"
+ },
+ "timeZone": {
+ "description": "Configured local time zone for the selected provider/service location.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "timeZone",
+ "observedAt",
+ "scope",
+ "revalidationRequired",
+ "terms",
+ "bookingConfirmed"
+ ],
+ "type": "object"
+ }
+]get_customer_policy2 fields changedInput schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider offer key. Selects its configured service location; not booking authority."New value: +"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "observedAt": {
- "type": "string"
- },
- "revalidationRequired": {
- "const": true,
- "type": "boolean"
- },
- "scope": {
- "const": "booking_preparation",
- "type": "string"
- },
- "status": {
- "const": "available",
- "type": "string"
- },
- "terms": {
- "additionalProperties": false,
- "properties": {
- "accountRequired": {
- "type": "boolean"
- },
- "bookerForGuestAllowed": {
- "type": "boolean"
- },
- "bookingConfirmation": {
- "const": "after_confirmed_full_payment",
- "type": "string"
- },
- "minimumLeadTimeMinutes": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "serviceSpecificTerms": {
- "const": "review_the_current_offer_before_confirmation",
- "type": "string"
- }
- },
- "required": [
- "minimumLeadTimeMinutes",
- "accountRequired",
- "bookerForGuestAllowed",
- "bookingConfirmation",
- "serviceSpecificTerms"
- ],
- "type": "object"
- },
- "timeZone": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "timeZone",
- "observedAt",
- "scope",
- "revalidationRequired",
- "terms",
- "bookingConfirmed"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation's contract; correct the facts before retrying.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "description": "Reading policy does not create or confirm a booking.",
+ "type": "boolean"
+ },
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "observedAt": {
+ "description": "Observation timestamp of the minimum-lead-time policy read; no validity window is promised.",
+ "type": "string"
+ },
+ "revalidationRequired": {
+ "const": true,
+ "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
+ "type": "boolean"
+ },
+ "scope": {
+ "const": "booking_preparation",
+ "description": "These rules cover preparation of a customer offer/booking, not action authority.",
+ "type": "string"
+ },
+ "status": {
+ "const": "available",
+ "description": "Current booking-preparation policy was read; no booking is confirmed.",
+ "type": "string"
+ },
+ "terms": {
+ "additionalProperties": false,
+ "description": "Current published account, guest-booking, lead-time and confirmation rules.",
+ "properties": {
+ "accountRequired": {
+ "description": "Whether current purchase policy requires an account.",
+ "type": "boolean"
+ },
+ "bookerForGuestAllowed": {
+ "description": "Whether current policy allows a booker to request service for another guest.",
+ "type": "boolean"
+ },
+ "bookingConfirmation": {
+ "const": "after_confirmed_full_payment",
+ "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
+ "type": "string"
+ },
+ "minimumLeadTimeMinutes": {
+ "description": "Current minimum time before pickup, expressed in minutes.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "serviceSpecificTerms": {
+ "const": "review_the_current_offer_before_confirmation",
+ "description": "Review the complete terms bound to the current offer before confirming.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "minimumLeadTimeMinutes",
+ "accountRequired",
+ "bookerForGuestAllowed",
+ "bookingConfirmation",
+ "serviceSpecificTerms"
+ ],
+ "type": "object"
+ },
+ "timeZone": {
+ "description": "Configured local time zone for the selected provider/service location.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "timeZone",
+ "observedAt",
+ "scope",
+ "revalidationRequired",
+ "terms",
+ "bookingConfirmed"
+ ],
+ "type": "object"
+ }
+]get_offer_status3 fields changedInput schema / properties / resumeToken / descriptionPrevious value: -"Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials."New value: +"Caller-generated private 64-character hexadecimal secret for this submission (32 random bytes). Keep its original submissionId pair. The stored resume proof expires 24 hours after first claimed intake; unchanged retries do not renew it. This is separate from offer.expiresAt and is not an account credential."Input schema / properties / submissionId / descriptionPrevious value: -"Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status."New value: +"Caller-generated UUID for one explicitly requested offer intent. Keep the same submissionId/resumeToken and unchanged facts for retries and status; a new explicit intent needs a new pair. This is not a bookingKey."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "pending",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "enum": [
- "conflict",
- "ambiguous",
- "not_found"
- ],
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "booking": {
- "additionalProperties": false,
- "properties": {
- "recordedStatus": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "bookingKey": {
- "maxLength": 128,
- "minLength": 1,
- "type": "string"
- },
- "bookingReference": {
- "minLength": 1,
- "type": "string"
- },
- "customerPortalUrl": {
- "format": "uri",
- "type": "string"
- },
- "fulfillment": {
- "additionalProperties": false,
- "properties": {
- "chauffeurAssignmentRecorded": {
- "type": "boolean"
- },
- "completionRecorded": {
- "type": "boolean"
- },
- "vehicleAssignmentRecorded": {
- "type": "boolean"
- }
- },
- "required": [
- "chauffeurAssignmentRecorded",
- "vehicleAssignmentRecorded",
- "completionRecorded"
- ],
- "type": "object"
- },
- "payment": {
- "additionalProperties": false,
- "properties": {
- "recordedStatus": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "status": {
- "const": "available",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingKey",
- "bookingReference",
- "booking",
- "payment",
- "fulfillment",
- "customerPortalUrl"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "code": {
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message",
- "review"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "expired",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "checkoutUrl": {
- "format": "uri",
- "type": "string"
- },
- "customerPortalUrl": {
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "type": "string"
- },
- "offer": {
- "additionalProperties": false,
- "properties": {
- "completeTermsBound": {
- "const": true,
- "type": "boolean"
- },
- "currency": {
- "const": "EUR",
- "type": "string"
- },
- "customerConfirmationRequired": {
- "const": true,
- "type": "boolean"
- },
- "expiresAt": {
- "type": "string"
- },
- "grossTotalCents": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "expiresAt",
- "customerConfirmationRequired",
- "completeTermsBound"
- ],
- "type": "object"
- },
- "status": {
- "const": "prepared",
- "type": "string"
- },
- "termsUrl": {
- "format": "uri",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingConfirmed",
- "checkoutUrl",
- "termsUrl",
- "offer",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation's contract; correct the facts before retrying.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "description": "Wait at least this many seconds, then use the same original submissionId/resumeToken pair for status or unchanged retry.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "pending",
+ "description": "The original offer-intent execution is still pending; no completed offer result is available.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "description": "Wait at least this many seconds before retrying the unchanged submissionId/resumeToken and facts.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Offer preparation admission was rate-limited; retry only the unchanged explicit offer intent.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "description": "conflict means stored intent/offer facts disagree; ambiguous means execution or bound evidence cannot safely be resolved; not_found denies access to the original submission proof. Inspect status rather than blindly creating another offer.",
+ "enum": [
+ "conflict",
+ "ambiguous",
+ "not_found"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "booking": {
+ "additionalProperties": false,
+ "description": "Booking state read from the stored reservation; it may lag provider events.",
+ "properties": {
+ "recordedStatus": {
+ "description": "Stored reservation status string. It is not a new provider confirmation.",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "bookingKey": {
+ "description": "Internal reservation ID for this selected booking. Returned in the available branch of get_offer_status/prepare_offer or an authorized booking read, not in prepared. It grants no access by itself.",
+ "maxLength": 128,
+ "minLength": 1,
+ "type": "string"
+ },
+ "bookingReference": {
+ "description": "Stored customer-visible reservation reference, falling back to bookingKey when absent. Customer OAuth accepts it only for its already-selected booking; it is not the supplier offerKey.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "description": "Private customer-login entry for the original submission proof. This available branch also returns this booking's ID/reference; no history or write authority is granted.",
+ "format": "uri",
+ "type": "string"
+ },
+ "fulfillment": {
+ "additionalProperties": false,
+ "description": "Flags derived from stored assignments and status, not live fulfillment confirmation.",
+ "properties": {
+ "chauffeurAssignmentRecorded": {
+ "description": "True when a chauffeur ID is stored on the reservation; it does not confirm dispatch or acceptance.",
+ "type": "boolean"
+ },
+ "completionRecorded": {
+ "description": "True only when the stored reservation status is completed; no fresh service-completion check is made.",
+ "type": "boolean"
+ },
+ "vehicleAssignmentRecorded": {
+ "description": "True when a vehicle ID is stored on the reservation; it does not confirm availability or execution.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "chauffeurAssignmentRecorded",
+ "vehicleAssignmentRecorded",
+ "completionRecorded"
+ ],
+ "type": "object"
+ },
+ "payment": {
+ "additionalProperties": false,
+ "description": "Recorded payment state from this booking, without a payment-provider refresh.",
+ "properties": {
+ "recordedStatus": {
+ "description": "Stored reservation payment-status string; no payment or refund is initiated or newly confirmed.",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "available",
+ "description": "The selected booking was accessible and its stored fields passed validation; no provider refresh occurred.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingKey",
+ "bookingReference",
+ "booking",
+ "payment",
+ "fulfillment",
+ "customerPortalUrl"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "description": "Customer-language explanation of the required review.",
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "description": "Structured reason and safe next step for requirements review.",
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "description": "This review result does not confirm availability.",
+ "type": "boolean"
+ },
+ "code": {
+ "description": "Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.",
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "description": "No customer contact is required for this price/requirements review.",
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "description": "Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "Offer preparation requires review of the ride facts/requirements; availability is not confirmed.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message",
+ "review"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "expired",
+ "description": "The existing bound offer has expired; this does not extend or describe the separate resume-proof lifetime.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "description": "Offer preparation does not confirm a booking or charge the customer.",
+ "type": "boolean"
+ },
+ "checkoutUrl": {
+ "description": "Private bound offer-review page to review complete terms and explicitly confirm using the existing flow. Treat this offer link as private.",
+ "format": "uri",
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "description": "Existing private customer-login entry with the original submissionId/resumeToken in its fragment. Keep it private; current session/proof authority is still required.",
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "description": "Guidance to open checkoutUrl, review the bound terms and explicitly confirm; no confirmation occurred in this call.",
+ "type": "string"
+ },
+ "offer": {
+ "additionalProperties": false,
+ "description": "Existing offer amount, expiry and confirmation/terms requirements.",
+ "properties": {
+ "completeTermsBound": {
+ "const": true,
+ "description": "Complete service/legal terms were verified as bound to this offer.",
+ "type": "boolean"
+ },
+ "currency": {
+ "const": "EUR",
+ "description": "Currency of the bound offer: EUR.",
+ "type": "string"
+ },
+ "customerConfirmationRequired": {
+ "const": true,
+ "description": "The customer must explicitly review and confirm the offer on its page.",
+ "type": "boolean"
+ },
+ "expiresAt": {
+ "description": "Stored offer expiry timestamp from offer_expires_at. Separate from the 24-hour submission resume-proof lifetime; re-review an expired or revised offer.",
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "description": "Bound offer gross total in EUR cents, including applicable tax.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "expiresAt",
+ "customerConfirmationRequired",
+ "completeTermsBound"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "prepared",
+ "description": "The existing unpaid draft and its bound offer links are ready for customer review; this branch does not return bookingKey/bookingReference.",
+ "type": "string"
+ },
+ "termsUrl": {
+ "description": "The same offer page with complete bound service/legal terms.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingConfirmed",
+ "checkoutUrl",
+ "termsUrl",
+ "offer",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]get_service_options2 fields changedInput schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider offer key. Selects its configured service location; not booking authority."New value: +"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "hourlyRideFacts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "location": {
- "additionalProperties": false,
- "properties": {
- "countryCode": {
- "type": "string"
- },
- "key": {
- "type": "string"
- },
- "label": {
- "type": "string"
- }
- },
- "required": [
- "key",
- "countryCode",
- "label"
- ],
- "type": "object"
- },
- "nextAction": {
- "type": "string"
- },
- "provider": {
- "type": "string"
- },
- "requiredRideFacts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "returnRideFacts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "services": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "availability": {
- "const": "requires_offer_review",
- "type": "string"
- },
- "key": {
- "type": "string"
- },
- "tripTypes": {
- "items": {
- "enum": [
- "one_way",
- "return"
- ],
- "type": "string"
- },
- "type": "array"
- }
- },
- "required": [
- "key",
- "tripTypes",
- "availability"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "status": {
- "const": "available",
- "type": "string"
- },
- "timeZone": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "provider",
- "timeZone",
- "bookingUrl",
- "services",
- "requiredRideFacts",
- "returnRideFacts",
- "hourlyRideFacts",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation's contract; correct the facts before retrying.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "hourlyRideFacts": {
+ "description": "Additional hourly-service fields and required service/trip-type values.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "location": {
+ "additionalProperties": false,
+ "description": "Location configured for the supplied published offerKey; omitted for the default service scope.",
+ "properties": {
+ "countryCode": {
+ "description": "Country code configured for this service location.",
+ "type": "string"
+ },
+ "key": {
+ "description": "Configured service-location key selected by the published supplier offerKey.",
+ "type": "string"
+ },
+ "label": {
+ "description": "Location label in the requested language.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "label"
+ ],
+ "type": "object"
+ },
+ "nextAction": {
+ "description": "Guidance to collect complete ride facts and request a price preview; no contact details are required for quoting.",
+ "type": "string"
+ },
+ "provider": {
+ "description": "Published display name of the service provider.",
+ "type": "string"
+ },
+ "requiredRideFacts": {
+ "description": "Ride fields to collect before quoting a transfer.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "returnRideFacts": {
+ "description": "Additional return-trip fields to collect for an outbound and later return pickup.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "services": {
+ "description": "Published service definitions and supported trip types.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "availability": {
+ "const": "requires_offer_review",
+ "description": "Availability/acceptance still require review of an actual offer.",
+ "type": "string"
+ },
+ "key": {
+ "description": "Published service identifier, such as transfer or hourly service.",
+ "type": "string"
+ },
+ "tripTypes": {
+ "description": "Trip types supported by this service definition; not confirmed availability.",
+ "items": {
+ "enum": [
+ "one_way",
+ "return"
+ ],
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "key",
+ "tripTypes",
+ "availability"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "const": "available",
+ "description": "Published service information is readable; no price, acceptance or availability is confirmed.",
+ "type": "string"
+ },
+ "timeZone": {
+ "description": "Configured local provider time zone for ride dates and pickup times.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "provider",
+ "timeZone",
+ "bookingUrl",
+ "services",
+ "requiredRideFacts",
+ "returnRideFacts",
+ "hourlyRideFacts",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]prepare_offer4 fields changedInput schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider offer key. Selects its configured service location; not booking authority."New value: +"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."Input schema / properties / resumeToken / descriptionPrevious value: -"Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials."New value: +"Caller-generated private 64-character hexadecimal secret for this submission (32 random bytes). Keep its original submissionId pair. The stored resume proof expires 24 hours after first claimed intake; unchanged retries do not renew it. This is separate from offer.expiresAt and is not an account credential."Input schema / properties / submissionId / descriptionPrevious value: -"Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status."New value: +"Caller-generated UUID for one explicitly requested offer intent. Keep the same submissionId/resumeToken and unchanged facts for retries and status; a new explicit intent needs a new pair. This is not a bookingKey."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "pending",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "retryAfterSeconds": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "type": "string"
- }
- },
- "required": [
- "status",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "enum": [
- "conflict",
- "ambiguous",
- "not_found"
- ],
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "booking": {
- "additionalProperties": false,
- "properties": {
- "recordedStatus": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "bookingKey": {
- "maxLength": 128,
- "minLength": 1,
- "type": "string"
- },
- "bookingReference": {
- "minLength": 1,
- "type": "string"
- },
- "customerPortalUrl": {
- "format": "uri",
- "type": "string"
- },
- "fulfillment": {
- "additionalProperties": false,
- "properties": {
- "chauffeurAssignmentRecorded": {
- "type": "boolean"
- },
- "completionRecorded": {
- "type": "boolean"
- },
- "vehicleAssignmentRecorded": {
- "type": "boolean"
- }
- },
- "required": [
- "chauffeurAssignmentRecorded",
- "vehicleAssignmentRecorded",
- "completionRecorded"
- ],
- "type": "object"
- },
- "payment": {
- "additionalProperties": false,
- "properties": {
- "recordedStatus": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "recordedStatus"
- ],
- "type": "object"
- },
- "status": {
- "const": "available",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingKey",
- "bookingReference",
- "booking",
- "payment",
- "fulfillment",
- "customerPortalUrl"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "code": {
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message",
- "review"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "expired",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "checkoutUrl": {
- "format": "uri",
- "type": "string"
- },
- "customerPortalUrl": {
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "type": "string"
- },
- "offer": {
- "additionalProperties": false,
- "properties": {
- "completeTermsBound": {
- "const": true,
- "type": "boolean"
- },
- "currency": {
- "const": "EUR",
- "type": "string"
- },
- "customerConfirmationRequired": {
- "const": true,
- "type": "boolean"
- },
- "expiresAt": {
- "type": "string"
- },
- "grossTotalCents": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "expiresAt",
- "customerConfirmationRequired",
- "completeTermsBound"
- ],
- "type": "object"
- },
- "status": {
- "const": "prepared",
- "type": "string"
- },
- "termsUrl": {
- "format": "uri",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingConfirmed",
- "checkoutUrl",
- "termsUrl",
- "offer",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation's contract; correct the facts before retrying.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "description": "Wait at least this many seconds, then use the same original submissionId/resumeToken pair for status or unchanged retry.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "pending",
+ "description": "The original offer-intent execution is still pending; no completed offer result is available.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "retryAfterSeconds": {
+ "description": "Wait at least this many seconds before retrying the unchanged submissionId/resumeToken and facts.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Offer preparation admission was rate-limited; retry only the unchanged explicit offer intent.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "description": "conflict means stored intent/offer facts disagree; ambiguous means execution or bound evidence cannot safely be resolved; not_found denies access to the original submission proof. Inspect status rather than blindly creating another offer.",
+ "enum": [
+ "conflict",
+ "ambiguous",
+ "not_found"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "booking": {
+ "additionalProperties": false,
+ "description": "Booking state read from the stored reservation; it may lag provider events.",
+ "properties": {
+ "recordedStatus": {
+ "description": "Stored reservation status string. It is not a new provider confirmation.",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "bookingKey": {
+ "description": "Internal reservation ID for this selected booking. Returned in the available branch of get_offer_status/prepare_offer or an authorized booking read, not in prepared. It grants no access by itself.",
+ "maxLength": 128,
+ "minLength": 1,
+ "type": "string"
+ },
+ "bookingReference": {
+ "description": "Stored customer-visible reservation reference, falling back to bookingKey when absent. Customer OAuth accepts it only for its already-selected booking; it is not the supplier offerKey.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "description": "Private customer-login entry for the original submission proof. This available branch also returns this booking's ID/reference; no history or write authority is granted.",
+ "format": "uri",
+ "type": "string"
+ },
+ "fulfillment": {
+ "additionalProperties": false,
+ "description": "Flags derived from stored assignments and status, not live fulfillment confirmation.",
+ "properties": {
+ "chauffeurAssignmentRecorded": {
+ "description": "True when a chauffeur ID is stored on the reservation; it does not confirm dispatch or acceptance.",
+ "type": "boolean"
+ },
+ "completionRecorded": {
+ "description": "True only when the stored reservation status is completed; no fresh service-completion check is made.",
+ "type": "boolean"
+ },
+ "vehicleAssignmentRecorded": {
+ "description": "True when a vehicle ID is stored on the reservation; it does not confirm availability or execution.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "chauffeurAssignmentRecorded",
+ "vehicleAssignmentRecorded",
+ "completionRecorded"
+ ],
+ "type": "object"
+ },
+ "payment": {
+ "additionalProperties": false,
+ "description": "Recorded payment state from this booking, without a payment-provider refresh.",
+ "properties": {
+ "recordedStatus": {
+ "description": "Stored reservation payment-status string; no payment or refund is initiated or newly confirmed.",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "recordedStatus"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "available",
+ "description": "The selected booking was accessible and its stored fields passed validation; no provider refresh occurred.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingKey",
+ "bookingReference",
+ "booking",
+ "payment",
+ "fulfillment",
+ "customerPortalUrl"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "description": "Customer-language explanation of the required review.",
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "description": "Structured reason and safe next step for requirements review.",
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "description": "This review result does not confirm availability.",
+ "type": "boolean"
+ },
+ "code": {
+ "description": "Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.",
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "description": "No customer contact is required for this price/requirements review.",
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "description": "Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "Offer preparation requires review of the ride facts/requirements; availability is not confirmed.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message",
+ "review"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "expired",
+ "description": "The existing bound offer has expired; this does not extend or describe the separate resume-proof lifetime.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "description": "Offer preparation does not confirm a booking or charge the customer.",
+ "type": "boolean"
+ },
+ "checkoutUrl": {
+ "description": "Private bound offer-review page to review complete terms and explicitly confirm using the existing flow. Treat this offer link as private.",
+ "format": "uri",
+ "type": "string"
+ },
+ "customerPortalUrl": {
+ "description": "Existing private customer-login entry with the original submissionId/resumeToken in its fragment. Keep it private; current session/proof authority is still required.",
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "description": "Guidance to open checkoutUrl, review the bound terms and explicitly confirm; no confirmation occurred in this call.",
+ "type": "string"
+ },
+ "offer": {
+ "additionalProperties": false,
+ "description": "Existing offer amount, expiry and confirmation/terms requirements.",
+ "properties": {
+ "completeTermsBound": {
+ "const": true,
+ "description": "Complete service/legal terms were verified as bound to this offer.",
+ "type": "boolean"
+ },
+ "currency": {
+ "const": "EUR",
+ "description": "Currency of the bound offer: EUR.",
+ "type": "string"
+ },
+ "customerConfirmationRequired": {
+ "const": true,
+ "description": "The customer must explicitly review and confirm the offer on its page.",
+ "type": "boolean"
+ },
+ "expiresAt": {
+ "description": "Stored offer expiry timestamp from offer_expires_at. Separate from the 24-hour submission resume-proof lifetime; re-review an expired or revised offer.",
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "description": "Bound offer gross total in EUR cents, including applicable tax.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "expiresAt",
+ "customerConfirmationRequired",
+ "completeTermsBound"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "prepared",
+ "description": "The existing unpaid draft and its bound offer links are ready for customer review; this branch does not return bookingKey/bookingReference.",
+ "type": "string"
+ },
+ "termsUrl": {
+ "description": "The same offer page with complete bound service/legal terms.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingConfirmed",
+ "checkoutUrl",
+ "termsUrl",
+ "offer",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]quote_ride2 fields changedInput schema / properties / offerKey / descriptionPrevious value: -"Optional existing published provider offer key. Selects its configured service location; not booking authority."New value: +"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "retryAfterSeconds": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "status": {
- "const": "rate_limited",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "retryAfterSeconds"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "review": {
- "additionalProperties": false,
- "properties": {
- "availabilityConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "code": {
- "enum": [
- "additional_requirements_review",
- "model_guarantee_review",
- "address_review",
- "service_scope_review",
- "booking_window_review",
- "route_review"
- ],
- "type": "string"
- },
- "customerContactRequired": {
- "const": false,
- "type": "boolean"
- },
- "nextAction": {
- "const": "review_requirements",
- "type": "string"
- }
- },
- "required": [
- "code",
- "customerContactRequired",
- "availabilityConfirmed",
- "nextAction"
- ],
- "type": "object"
- },
- "status": {
- "const": "review_required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "message"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingConfirmed": {
- "const": false,
- "type": "boolean"
- },
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "nextAction": {
- "type": "string"
- },
- "quote": {
- "additionalProperties": false,
- "properties": {
- "billableHoursPerServiceLine": {
- "exclusiveMinimum": 0,
- "type": "number"
- },
- "calculatedAt": {
- "type": "string"
- },
- "currency": {
- "type": "string"
- },
- "grossTotalCents": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "parkingIncluded": {
- "type": "boolean"
- },
- "pricesIncludeVat": {
- "type": "boolean"
- },
- "revalidationRequired": {
- "const": true,
- "type": "boolean"
- },
- "serviceLines": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "direction": {
- "enum": [
- "outbound",
- "return"
- ],
- "type": "string"
- },
- "grossAmountCents": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "direction",
- "grossAmountCents"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "tollsIncluded": {
- "type": "boolean"
- },
- "vatRateBasisPoints": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "vehicleCount": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "currency",
- "grossTotalCents",
- "pricesIncludeVat",
- "vatRateBasisPoints",
- "parkingIncluded",
- "tollsIncluded",
- "vehicleCount",
- "billableHoursPerServiceLine",
- "serviceLines",
- "calculatedAt",
- "revalidationRequired"
- ],
- "type": "object"
- },
- "status": {
- "const": "quoted",
- "type": "string"
- }
- },
- "required": [
- "status",
- "bookingUrl",
- "bookingConfirmed",
- "quote",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "description": "Input does not match this operation's contract; correct the facts before retrying.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "retryAfterSeconds": {
+ "description": "Wait at least this many seconds before retrying the same quote request.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "const": "rate_limited",
+ "description": "Quote admission is currently rate-limited; no quote was returned.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "retryAfterSeconds"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "message": {
+ "description": "Customer-language explanation of the required review.",
+ "type": "string"
+ },
+ "review": {
+ "additionalProperties": false,
+ "description": "Structured review reason and next step when supplied; not an availability confirmation.",
+ "properties": {
+ "availabilityConfirmed": {
+ "const": false,
+ "description": "This review result does not confirm availability.",
+ "type": "boolean"
+ },
+ "code": {
+ "description": "Reason for further requirements, model, address, service-scope, booking-window or route review; not vehicle-unavailability evidence.",
+ "enum": [
+ "additional_requirements_review",
+ "model_guarantee_review",
+ "address_review",
+ "service_scope_review",
+ "booking_window_review",
+ "route_review"
+ ],
+ "type": "string"
+ },
+ "customerContactRequired": {
+ "const": false,
+ "description": "No customer contact is required for this price/requirements review.",
+ "type": "boolean"
+ },
+ "nextAction": {
+ "const": "review_requirements",
+ "description": "Review the stated requirements before proceeding; do not infer acceptance or confirmed availability.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "customerContactRequired",
+ "availabilityConfirmed",
+ "nextAction"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "review_required",
+ "description": "The ride facts or requirements require further review; no availability conclusion is made.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "message"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingConfirmed": {
+ "const": false,
+ "description": "A quote does not confirm or create a booking.",
+ "type": "boolean"
+ },
+ "bookingUrl": {
+ "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+ "format": "uri",
+ "type": "string"
+ },
+ "nextAction": {
+ "description": "Guidance to proceed only to an explicitly requested offer after reviewing the preview.",
+ "type": "string"
+ },
+ "quote": {
+ "additionalProperties": false,
+ "description": "Calculated price preview and tax/inclusion breakdown; no reservation or availability confirmation.",
+ "properties": {
+ "billableHoursPerServiceLine": {
+ "description": "Billable hours used for each calculated service line.",
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "calculatedAt": {
+ "description": "Timestamp of this preview calculation, not a guaranteed price-validity window.",
+ "type": "string"
+ },
+ "currency": {
+ "description": "Currency of the price preview.",
+ "type": "string"
+ },
+ "grossTotalCents": {
+ "description": "Gross total of the preview in the returned currency's minor units (EUR cents).",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "parkingIncluded": {
+ "description": "Whether parking costs are included in the preview.",
+ "type": "boolean"
+ },
+ "pricesIncludeVat": {
+ "description": "Whether the returned price includes VAT.",
+ "type": "boolean"
+ },
+ "revalidationRequired": {
+ "const": true,
+ "description": "Revalidate price and terms before preparing or confirming an offer.",
+ "type": "boolean"
+ },
+ "serviceLines": {
+ "description": "Price breakdown by outbound/return service line.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "direction": {
+ "description": "The outbound or return leg priced by this service line.",
+ "enum": [
+ "outbound",
+ "return"
+ ],
+ "type": "string"
+ },
+ "grossAmountCents": {
+ "description": "Gross price for this service line in the returned currency's minor units.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "direction",
+ "grossAmountCents"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "tollsIncluded": {
+ "description": "Whether toll costs are included in the preview.",
+ "type": "boolean"
+ },
+ "vatRateBasisPoints": {
+ "description": "VAT rate in basis points: 10000 basis points equal 100 percent.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "vehicleCount": {
+ "description": "Vehicle count used in this price calculation, not confirmed vehicle availability.",
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "currency",
+ "grossTotalCents",
+ "pricesIncludeVat",
+ "vatRateBasisPoints",
+ "parkingIncluded",
+ "tollsIncluded",
+ "vehicleCount",
+ "billableHoursPerServiceLine",
+ "serviceLines",
+ "calculatedAt",
+ "revalidationRequired"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "const": "quoted",
+ "description": "A price preview was calculated; it must be revalidated before an actual offer.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "bookingUrl",
+ "bookingConfirmed",
+ "quote",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]prepare_offer1 field changedInput schema / properties / contact / properties / email / patternPrevious value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"get_customer_policy1 field changedInput schema / properties / offerKeyAdded value: +{
+ "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.",
+ "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$",
+ "type": "string"
+}get_service_options2 fields changedInput schema / properties / offerKeyAdded value: +{
+ "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.",
+ "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$",
+ "type": "string"
+}Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "invalid_request",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "status": {
- "const": "unavailable",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "bookingUrl": {
- "format": "uri",
- "type": "string"
- },
- "hourlyRideFacts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "nextAction": {
- "type": "string"
- },
- "provider": {
- "type": "string"
- },
- "requiredRideFacts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "returnRideFacts": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "services": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "availability": {
- "const": "requires_offer_review",
- "type": "string"
- },
- "key": {
- "type": "string"
- },
- "tripTypes": {
- "items": {
- "enum": [
- "one_way",
- "return"
- ],
- "type": "string"
- },
- "type": "array"
- }
- },
- "required": [
- "key",
- "tripTypes",
- "availability"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "status": {
- "const": "available",
- "type": "string"
- },
- "timeZone": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "provider",
- "timeZone",
- "bookingUrl",
- "services",
- "requiredRideFacts",
- "returnRideFacts",
- "hourlyRideFacts",
- "nextAction"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "invalid_request",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "const": "unavailable",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "bookingUrl": {
+ "format": "uri",
+ "type": "string"
+ },
+ "hourlyRideFacts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "location": {
+ "additionalProperties": false,
+ "properties": {
+ "countryCode": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "key",
+ "countryCode",
+ "label"
+ ],
+ "type": "object"
+ },
+ "nextAction": {
+ "type": "string"
+ },
+ "provider": {
+ "type": "string"
+ },
+ "requiredRideFacts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "returnRideFacts": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "services": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "availability": {
+ "const": "requires_offer_review",
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "tripTypes": {
+ "items": {
+ "enum": [
+ "one_way",
+ "return"
+ ],
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "key",
+ "tripTypes",
+ "availability"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "const": "available",
+ "type": "string"
+ },
+ "timeZone": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "provider",
+ "timeZone",
+ "bookingUrl",
+ "services",
+ "requiredRideFacts",
+ "returnRideFacts",
+ "hourlyRideFacts",
+ "nextAction"
+ ],
+ "type": "object"
+ }
+]Public chauffeur information, policies and anonymous price previews in the provider’s published service areas. On explicit customer request, prepare a binding unpaid offer using email OR E.164 phone, without an account. Customers review bound terms and explicitly confirm in Samuelz checkout. The same endpoint provides OAuth-protected booking status, payment review, history, and amendment/cancellation workflows. Booking data and actions require authorized customer access; changes and cancellations require the applicable object-bound consent. Tool discovery is public. Quotes do not guarantee availability, and MCP does not take payment.
Get date-specific quotes and book private UK airport and cruise-port transfers through your AI assistant. Compare vehicle options, validate flights, retrieve bookings, amend details and cancel with customer confirmation. No registration required to start, subject to service limits; optional API-key and OAuth access for registered integrations. Transfer fares are payable separately and cancellation conditions apply. Live demo and connection instructions: https://ai.airport-pickups-london.com/ Technical documentation: https://mcp.airport-pickups-london.com/docs
Find local services, read availability, and create short-lived booking holds.
Book a private driver in Paris: live quotes, airport transfers, tours, VIP Meet & Greet. No auth.
Add one secure layer between your agents and this server.
