> ## 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.

# Quote a sale

> Prices the items and holds the price until `expiresAt`. Execute the quote by its `quoteId`.

**Rate limit:** 120 requests per minute per API key.



## OpenAPI

````yaml /execution-v3/openapi.json post /execution/v3/sell/quotes
openapi: 3.1.0
info:
  title: Pure Execution API v3
  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
security:
  - apiKey: []
tags:
  - name: Execution
    description: >-
      Quote a sale, then execute the quote by id. Limited to approved
      organizations.
paths:
  /execution/v3/sell/quotes:
    post:
      tags:
        - Execution
      summary: Quote a sale
      description: >-
        Prices the items and holds the price until `expiresAt`. Execute the
        quote by its `quoteId`.


        **Rate limit:** 120 requests per minute per API key.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  minItems: 1
                  maxItems: 50
                  type: array
                  items:
                    anyOf:
                      - type: object
                        properties:
                          offerId:
                            type: string
                            format: uuid
                            pattern: >-
                              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                            description: The offer to sell into
                          quantity:
                            type: integer
                            minimum: 1
                            maximum: 999999
                            description: Units to sell
                        required:
                          - offerId
                          - quantity
                        additionalProperties: false
                      - type: object
                        properties:
                          productId:
                            type: string
                            format: uuid
                            pattern: >-
                              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                            description: >-
                              The product to sell; the best offer for it is
                              chosen
                          variantId:
                            type: string
                            format: uuid
                            pattern: >-
                              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          quantity:
                            type: integer
                            minimum: 1
                            maximum: 999999
                            description: Units to sell
                        required:
                          - productId
                          - variantId
                          - quantity
                        additionalProperties: false
                  description: Each item names an offer, or a product and variant
                optionals:
                  description: Add-ons to include
                  maxItems: 2
                  type: array
                  items:
                    type: string
                    enum:
                      - instant_payout
                      - overnight_label
                promotionCode:
                  type: string
                  minLength: 1
                  maxLength: 64
              required:
                - items
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  quoteId:
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                    description: >-
                      Execute it with POST
                      /execution/v3/sell/quotes/{quoteId}/execute
                  expiresAt:
                    type: string
                    description: ISO 8601; the quote cannot be executed after this
                  payout:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: What the seller is paid, in cents
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        offerId:
                          type: string
                        productId:
                          type: string
                        variantId:
                          type:
                            - string
                            - 'null'
                        quantity:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        unitPrice:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Cents
                            - type: 'null'
                      required:
                        - offerId
                        - productId
                        - variantId
                        - quantity
                        - unitPrice
                      additionalProperties: false
                  breakdown:
                    type: object
                    properties:
                      subtotal:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        description: Cents
                      fees:
                        type: array
                        items:
                          type: object
                          properties:
                            label:
                              type: string
                            amount:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Negative
                          required:
                            - label
                            - amount
                          additionalProperties: false
                      promotions:
                        type: array
                        items:
                          type: object
                          properties:
                            label:
                              type: string
                            amount:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Cents
                          required:
                            - label
                            - amount
                          additionalProperties: false
                    required:
                      - subtotal
                      - fees
                      - promotions
                    additionalProperties: false
                  optionals:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          enum:
                            - instant_payout
                            - overnight_label
                        title:
                          type: string
                        selected:
                          type: boolean
                        available:
                          type: boolean
                        fee:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Cents
                            - type: 'null'
                        payoutWith:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Cents
                            - type: 'null'
                        payoutWithout:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Cents
                            - type: 'null'
                        unavailable:
                          anyOf:
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - requote
                                    - account_action_required
                                    - try_again
                                    - invalid_request
                                  description: What to do about it
                                reason:
                                  type: string
                                  description: The specific cause, stable for code
                                message:
                                  type: string
                              required:
                                - kind
                                - reason
                                - message
                              additionalProperties: false
                            - type: 'null'
                      required:
                        - id
                        - title
                        - selected
                        - available
                        - fee
                        - payoutWith
                        - payoutWithout
                        - unavailable
                      additionalProperties: false
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - requote
                            - account_action_required
                            - try_again
                            - invalid_request
                          description: What to do about it
                        reason:
                          type: string
                          description: The specific cause, stable for code
                        message:
                          type: string
                      required:
                        - kind
                        - reason
                        - message
                      additionalProperties: false
                    description: Empty when the quote can be executed
                required:
                  - quoteId
                  - expiresAt
                  - payout
                  - items
                  - breakdown
                  - optionals
                  - issues
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: number
                  suggestion:
                    type: string
                  requestId:
                    type: string
                  errorCode:
                    type: string
                  details:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - error
                  - code
                  - suggestion
                  - requestId
                additionalProperties: false
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: API key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.