> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collectpure.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Execute a buy order

> Execute a previously created buy quote. Validates the quote, charges payment, and creates orders. The quote must not be expired.

**Rate limit:** 120 requests burst, 60 requests/minute sustained.



## OpenAPI

````yaml /api-reference/openapi.json post /execution/buy/v1
openapi: 3.1.0
info:
  title: Pure Public API
  description: >-
    Public API for accessing Pure marketplace data including products, spot
    prices, and more.
  version: 2.0.0
  license:
    name: Proprietary
servers:
  - url: https://api.collectpure.com/
    description: Production server
  - url: https://sandbox.api.collectpure.com/
    description: Sandbox server
security:
  - apiKey: []
tags:
  - name: Root
    description: API information and status
  - name: Products
    description: >-
      Enriched product endpoints — full product details, search, and catalog
      metadata
  - name: Listings
    description: Listing management — create, update, deactivate, list, and view statistics
  - name: Offers
    description: Offer management — create, update, deactivate, list, and view statistics
  - name: Orders
    description: Purchase and sale order management for authenticated organizations
  - name: Marketplace
    description: Spot prices, marketplace statistics, shipping dates, and sitemap data
  - name: Organization
    description: Organization details and settings management
  - name: Inventory
    description: >-
      Inventory management — view items and aggregate statistics for your
      organization
  - name: Products (Legacy)
    description: Legacy product endpoints — use the enriched Products endpoints instead
  - name: Listings (Legacy)
    description: Legacy listing endpoints — use Orderbook endpoints instead
  - name: Offers (Legacy)
    description: Legacy offer endpoints — use Orderbook endpoints instead
  - name: Execution - Buy
    description: Buy execution — quotes, payment methods, and order placement
  - name: Execution - Sell
    description: Sell execution — quotes, payout methods, and order placement
  - name: Sandbox
    description: >-
      Sandbox-only endpoints for discovering test data — not available in
      production
paths:
  /execution/buy/v1:
    post:
      tags:
        - Execution - Buy
      summary: Execute a buy order
      description: >-
        Execute a previously created buy quote. Validates the quote, charges
        payment, and creates orders. The quote must not be expired.


        **Rate limit:** 120 requests burst, 60 requests/minute sustained.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                quoteId:
                  type: string
                  description: The quote ID from /execution/buy/quote/v1
                expectedTotal:
                  type: integer
                  minimum: 0
                  maximum: 9007199254740991
                  description: >-
                    The total from the quote response, in cents. The order is
                    rejected if the current total exceeds this value.
                paymentMethod:
                  type: string
                  description: >-
                    'wire_transfer' or a Stripe payment method ID (pm_... or
                    ba_...)
                shipping:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Recipient name
                    line1:
                      type: string
                      description: Street address
                    line2:
                      description: Apartment, suite, etc.
                      type: string
                    city:
                      type: string
                      description: City
                    state:
                      type: string
                      description: State or province
                    postalCode:
                      type: string
                      description: Postal / ZIP code
                    country:
                      type: string
                      description: Country code
                    phone:
                      description: Phone number
                      type: string
                  required:
                    - name
                    - line1
                    - city
                    - state
                    - postalCode
                    - country
              required:
                - quoteId
                - expectedTotal
                - paymentMethod
                - shipping
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - complete
                          - partial
                      orderId:
                        type: number
                        description: The main order ID
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            lineItemId:
                              type: string
                            productId:
                              type: string
                            variantId:
                              type: string
                            quantity:
                              type: number
                            price:
                              type: number
                              description: Unit price in cents
                            total:
                              type: number
                              description: Line total in cents
                            success:
                              type: boolean
                          required:
                            - lineItemId
                            - productId
                            - variantId
                            - quantity
                            - price
                            - total
                            - success
                          additionalProperties: false
                      checkout:
                        type: object
                        properties:
                          id:
                            type: string
                          currency:
                            type: string
                          expiresAt:
                            type: string
                          lineItems:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                quantity:
                                  type: number
                                price:
                                  anyOf:
                                    - type: number
                                    - type: 'null'
                                status:
                                  type: string
                                disabled:
                                  type: boolean
                                error:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                product:
                                  type: object
                                  properties:
                                    sku:
                                      type: string
                                    title:
                                      type: string
                                  required:
                                    - sku
                                    - title
                                  additionalProperties: false
                                variant:
                                  type: object
                                  properties:
                                    title:
                                      type: string
                                  required:
                                    - title
                                  additionalProperties: false
                              required:
                                - id
                                - quantity
                                - price
                                - status
                                - disabled
                                - error
                                - product
                                - variant
                              additionalProperties: false
                          fees:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                label:
                                  type: string
                                amount:
                                  type: number
                                rate:
                                  type: number
                              required:
                                - id
                                - label
                                - amount
                              additionalProperties: false
                          salesTax:
                            type: number
                            description: Sales tax in cents
                          subtotal:
                            type: number
                            description: Subtotal in cents
                          total:
                            type: number
                            description: Total in cents
                          availableCount:
                            type: number
                          unavailableCount:
                            type: number
                          allowCardPayments:
                            type: boolean
                          allowAch:
                            type: boolean
                        required:
                          - id
                          - currency
                          - expiresAt
                          - lineItems
                          - fees
                          - salesTax
                          - subtotal
                          - total
                          - availableCount
                          - unavailableCount
                          - allowCardPayments
                          - allowAch
                        additionalProperties: false
                    required:
                      - status
                      - orderId
                      - items
                      - checkout
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: API key for authentication

````