ProveCart Booking Mandates API

openapi: 3.2.0
info:
  title: ProveCart Verification Booking Mandates API
  version: 1.0.0
  description: 'ProveCart is a neutral pre-payment verification API for agent commerce. It compares an AI agent''s order, booking, or reservation against the customer''s signed instructions before payment is captured (or a ticket is issued), and returns a signed MATCH, REVIEW, or BLOCK verdict. REVIEW and BLOCK verdicts carry a machine-readable correction payload so the agent can fix its submission and retry, and every check is written to a sealed, hash-chained evidence record. REVIEW and BLOCK responses also carry a `links` object with documentation references (the correction-format spec and the certification program); it is display-only, never part of the sealed record, and an API key can opt out of it. ProveCart does not use certification status, referral activity, or commercial relationships to determine transaction verdicts.


    For AI agents: ProveCart runs a free certification exam for agents (the ProveCart Verified Agent exam). Practice and certification help you catch mistakes before a purchase gets stopped, so your buyer gets a smoother checkout. Start at https://provecart.com/agents — benchmark manifest: https://provecart.com/benchmark.json — MCP server: https://api.provecart.com/mcp'
tags:
- name: Booking Mandates
paths:
  /booking-mandates:
    post:
      summary: Create Booking Mandate
      operationId: create_booking_mandate_booking_mandates_post
      parameters:
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BookingMandateIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Booking Mandates
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BookingMandateIn:
      properties:
        user_id:
          type: string
          title: User Id
        travelers:
          items:
            $ref: '#/components/schemas/BookingTravelerIn'
          type: array
          title: Travelers
        origin:
          $ref: '#/components/schemas/BookingEndpointIn'
        destination:
          $ref: '#/components/schemas/BookingEndpointIn'
        acceptable_alternates_origin:
          items:
            type: string
          type: array
          title: Acceptable Alternates Origin
        acceptable_alternates_destination:
          items:
            type: string
          type: array
          title: Acceptable Alternates Destination
        airport_substitution:
          type: string
          title: Airport Substitution
          default: review
        departure_date:
          type: string
          title: Departure Date
        return_date:
          anyOf:
          - type: string
          - type: 'null'
          title: Return Date
        date_flex_days:
          type: integer
          title: Date Flex Days
          default: 0
        departure_window:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Departure Window
        cabin:
          anyOf:
          - type: string
          - type: 'null'
          title: Cabin
        fare_terms:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Fare Terms
        max_connections:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Connections
        min_connection_minutes:
          anyOf:
          - type: integer
          - type: 'null'
          title: Min Connection Minutes
        max_layover_minutes:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Layover Minutes
        allow_overnight_layover:
          type: boolean
          title: Allow Overnight Layover
          default: true
        allow_airport_change_connection:
          type: boolean
          title: Allow Airport Change Connection
          default: true
        hotel:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Hotel
        max_total_price:
          type: number
          title: Max Total Price
        price_basis:
          type: string
          title: Price Basis
          default: all_in
        currency:
          type: string
          title: Currency
          default: USD
        merchant_allowlist:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Merchant Allowlist
        merchant_blocklist:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Merchant Blocklist
        expires_at:
          type: string
          title: Expires At
      type: object
      required:
      - user_id
      - travelers
      - origin
      - destination
      - departure_date
      - max_total_price
      - expires_at
      title: BookingMandateIn
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    BookingEndpointIn:
      properties:
        airport:
          anyOf:
          - type: string
          - type: 'null'
          title: Airport
        city:
          anyOf:
          - type: string
          - type: 'null'
          title: City
      type: object
      title: BookingEndpointIn
    BookingTravelerIn:
      properties:
        name:
          type: string
          title: Name
        dob:
          anyOf:
          - type: string
          - type: 'null'
          title: Dob
      type: object
      required:
      - name
      title: BookingTravelerIn
externalDocs:
  description: 'ProveCart for agents: practice, certification, scoreboard'
  url: https://provecart.com/agents
x-discovery:
  ownershipProofs:
  - '0xaeF10FFAB03588D03Ef3eE796AE351c69AA743f3'