ProveCart Reservation Mandates API

openapi: 3.2.0
info:
  title: ProveCart Verification Reservation 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: Reservation Mandates
paths:
  /reservation-mandates:
    post:
      summary: Create Reservation Mandate
      operationId: create_reservation_mandate_reservation_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/ReservationMandateIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Reservation Mandates
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ReservationMandateIn:
      properties:
        user_id:
          type: string
          title: User Id
        service_description:
          type: string
          title: Service Description
        provider_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Provider Name
        location:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Location
        location_exact:
          type: boolean
          title: Location Exact
          default: false
        date:
          type: string
          title: Date
        time:
          type: string
          title: Time
        time_tolerance_minutes:
          type: integer
          title: Time Tolerance Minutes
          default: 0
        party_size:
          type: integer
          title: Party Size
        party_size_max:
          anyOf:
          - type: integer
          - type: 'null'
          title: Party Size Max
        name_on_reservation:
          type: string
          title: Name On Reservation
        max_deposit:
          anyOf:
          - type: number
          - type: 'null'
          title: Max Deposit
        max_total_price:
          type: number
          title: Max Total Price
        currency:
          type: string
          title: Currency
          default: USD
        cancellation:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Cancellation
        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
      - service_description
      - date
      - time
      - party_size
      - name_on_reservation
      - max_total_price
      - expires_at
      title: ReservationMandateIn
    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
externalDocs:
  description: 'ProveCart for agents: practice, certification, scoreboard'
  url: https://provecart.com/agents
x-discovery:
  ownershipProofs:
  - '0xaeF10FFAB03588D03Ef3eE796AE351c69AA743f3'