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

# Get a purchase order

> Retrieve a single purchase order by ID for the authenticated organization. `id` is the `orderId` returned by `POST /execution/v2/sell/quotes/:quoteId/execute`. Use `shippingLabelUrl` to poll for the outbound shipping label — it is null until fulfillment generates it.

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



## OpenAPI

````yaml /api-reference/openapi.json get /orders/get-purchase-order/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: >-
      Orders from Pure's fulfillment side: purchase orders are your sells
      (inbound to Pure), sale orders are your buys (outbound from Pure)
  - name: Marketplace
    description: Spot prices, marketplace statistics, shipping dates, and sitemap data
  - name: Organization
    description: Organization details, settings, and product watchlist management
  - name: Inventory
    description: >-
      Inventory management — view items and aggregate statistics for your
      organization
  - name: Vault
    description: >-
      Vault shipping — intake shipments, holdings, fulfillment, and outbound
      requests
  - name: Vault (Alpha)
    description: >-
      Alpha vault reads — intake address, inventory, inbound/outbound shipments,
      and outbound-request v2. Subject to change.
  - 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: Execution
    description: Execution meta — trading status and shared execution resources
  - name: Sandbox
    description: >-
      Sandbox-only endpoints for discovering test data — not available in
      production
paths:
  /orders/get-purchase-order/v1:
    get:
      tags:
        - Orders
      summary: Get a purchase order
      description: >-
        Retrieve a single purchase order by ID for the authenticated
        organization. `id` is the `orderId` returned by `POST
        /execution/v2/sell/quotes/:quoteId/execute`. Use `shippingLabelUrl` to
        poll for the outbound shipping label — it is null until fulfillment
        generates it.


        **Rate limit:** 120 requests burst, 60 requests/minute sustained.
      parameters:
        - schema:
            type: number
            exclusiveMinimum: 0
          in: query
          name: id
          required: true
          description: Purchase order ID — the orderId from sell execute
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: number
                      trackingIds:
                        anyOf:
                          - type: array
                            items:
                              type: string
                          - type: 'null'
                      status:
                        type: string
                        enum:
                          - pending_confirmation
                          - ready_for_shipment
                          - in_transit
                          - items_received
                          - check_in_progress
                          - order_complete
                          - order_cancelled
                          - check_in_complete
                      subtotal:
                        type: number
                        description: Subtotal in cents
                      salesTax:
                        type: number
                        description: Sales tax in cents
                      shipping:
                        anyOf:
                          - type: number
                          - type: 'null'
                        description: Shipping fee in cents
                      processingFee:
                        anyOf:
                          - type: number
                          - type: 'null'
                        description: Processing fee in cents
                      total:
                        type: number
                        description: Order total in cents
                      currency:
                        anyOf:
                          - type: string
                          - type: 'null'
                      shippingLabelUrl:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: >-
                          Outbound shipping-label URL once generated. Null until
                          fulfillment creates the label — poll this endpoint; it
                          is not instant after execute.
                      createdAt:
                        anyOf:
                          - type: string
                          - type: 'null'
                      updatedAt:
                        anyOf:
                          - type: string
                          - type: 'null'
                      completeAt:
                        anyOf:
                          - type: string
                          - type: 'null'
                    required:
                      - id
                      - trackingIds
                      - status
                      - subtotal
                      - salesTax
                      - shipping
                      - processingFee
                      - total
                      - currency
                      - shippingLabelUrl
                      - createdAt
                      - updatedAt
                      - completeAt
                    additionalProperties: false
                required:
                  - data
                additionalProperties: false
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: API key for authentication

````