openapi: 3.1.0
info:
  title: Bourdain API
  version: '2026-10-16'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-16: 6 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Bourdain has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 6
    pages-with-code: 6
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-16'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.bourdain.io/docs/api
  - https://www.bourdain.io/docs/mcp
  - https://www.bourdain.io/docs/examples
  - https://www.bourdain.io/docs/playground
  - https://www.bourdain.io/docs/authentication
  - https://www.bourdain.io/docs/getting-started
  - https://www.bourdain.io/docs/rate-limits
servers:
- url: https://bourdain.io
paths:
  /acp-checkout:
    post:
      operationId: post_acp_checkout
      tags:
      - Acp Checkout
      summary: Initiate purchase flow
      x-source: https://www.bourdain.io/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAcpCheckoutRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAcpCheckoutResponse'
      x-evidence:
        kind: documentation
  /acp-confirm:
    post:
      operationId: post_acp_confirm
      tags:
      - Acp Confirm
      summary: Confirm and finalize order
      x-source: https://www.bourdain.io/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAcpConfirmRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAcpConfirmResponse'
      x-evidence:
        kind: documentation
  /acp-payment:
    post:
      operationId: post_acp_payment
      tags:
      - Acp Payment
      summary: Process payment
      x-source: https://www.bourdain.io/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAcpPaymentRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAcpPaymentResponse'
      x-evidence:
        kind: documentation
  /acp-product/{id}:
    get:
      operationId: get_acp_product_id
      tags:
      - Acp Product
      summary: Get single listing details
      x-source: https://www.bourdain.io/docs/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAcpProductIdResponse'
      x-evidence:
        kind: documentation
  /acp-products:
    get:
      operationId: get_acp_products
      tags:
      - Acp Products
      summary: Search and filter listings
      x-source: https://www.bourdain.io/docs/api
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
        description: Search term (card name, set, etc.)
      - name: condition
        in: query
        required: false
        schema:
          type: string
        description: Mint, Near Mint, Excellent, Good, Played
      - name: rarity
        in: query
        required: false
        schema:
          type: string
        description: Common, Uncommon, Rare, Rare Holo, etc.
      - name: set
        in: query
        required: false
        schema:
          type: string
        description: Set code (e.g., sv7, base1)
      - name: min_price
        in: query
        required: false
        schema:
          type: number
        description: Minimum price in GBP
      - name: max_price
        in: query
        required: false
        schema:
          type: number
        description: Maximum price in GBP
      - name: trade_enabled
        in: query
        required: false
        schema:
          type: boolean
        description: Only show trade-eligible listings
      - name: limit
        in: query
        required: false
        schema:
          type: number
        description: 'Results per page (default: 20, max: 100)'
      - name: page
        in: query
        required: false
        schema:
          type: number
        description: Page number for pagination
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAcpProductsResponse'
      x-evidence:
        kind: documentation
  /mcp-server:
    post:
      operationId: post_mcp_server
      tags:
      - Mcp Server
      summary: The Model Context Protocol is a standard for AI agents to interact with external services.
      description: All MCP requests use JSON-RPC 2.0 format sent to the single endpoint.
      x-source: https://www.bourdain.io/docs/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpServerRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostAcpCheckoutRequest:
      type: object
      properties:
        listing_id:
          type: string
          description: Listing to purchase
        shipping_address:
          type: object
          description: Delivery address
        buyer_email:
          type: string
          description: Email for order confirmation
      required:
      - listing_id
      - shipping_address
    PostAcpCheckoutResponse:
      type: object
      properties:
        success:
          type: boolean
        checkout_session_id:
          type: string
        payment_options:
          type: array
    PostAcpConfirmRequest:
      type: object
      properties:
        order_id:
          type: string
          description: Order ID from payment response
      required:
      - order_id
    PostAcpConfirmResponse:
      type: object
      properties:
        success:
          type: boolean
        status:
          type: string
          description: Final order status
    PostAcpPaymentRequest:
      type: object
      properties:
        checkout_session_id:
          type: string
          description: Session ID from checkout
        payment_method:
          type: string
          description: wallet, stripe, or split
        stripe_payment_method_id:
          type: string
          description: Required for stripe or split
      required:
      - checkout_session_id
      - payment_method
    PostAcpPaymentResponse:
      type: object
      properties:
        success:
          type: boolean
        order_id:
          type: string
    GetAcpProductIdResponse:
      type: object
      properties:
        success:
          type: boolean
        product:
          type: object
          description: Detailed product information
    GetAcpProductsResponse:
      type: object
      properties:
        success:
          type: boolean
        products:
          type: array
          description: List of product objects
        total_count:
          type: integer
        page:
          type: integer
        has_more:
          type: boolean
    PostMcpServerRequest:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON-RPC version, always "2.0"
        id:
          type: string
          description: Unique request identifier
        method:
          type: string
          description: Tool name to invoke (e.g., "search_listings", "create_listing", etc.)
        params:
          type: object
          description: Tool‑specific parameters as documented for each method
      required:
      - jsonrpc
      - id
      - method
      - params
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: Authorization
      x-source: https://www.bourdain.io/docs/authentication
tags:
- name: Acp Checkout
- name: Acp Confirm
- name: Acp Payment
- name: Acp Product
- name: Acp Products
- name: Mcp Server
security:
- Authorization: []