Execution v3 - Pure API Documentation

Execution v3 sells into offers in two calls: create a quote, then execute it by its quoteId. The quote holds the price for 60 seconds, so execute sends no body.

Both routes require an Admin API key (stytch_admin). See Authentication.

Build against sandbox first: https://sandbox.api.collectpure.com with a sandbox API key. Sandbox orders are not real.

How it works

POST /execution/v3/sell/quotes prices your items and returns a quoteId.
POST /execution/v3/sell/quotes/{quoteId}/execute places the sale at the quoted payout or better.
A quote executes once. After it executes, fails, or expires, create a new quote.

Quote

curl -X POST https://api.collectpure.com/execution/v3/sell/quotes \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{ "offerId": "OFFER_UUID", "quantity": 1 }],
    "optionals": ["overnight_label"]
  }'

{
  "quoteId": "2f1d48ff-1903-4531-9e28-4557ba549370",
  "expiresAt": "2026-11-05T00:35:49.457Z",
  "payout": 3257,
  "items": [
    {
      "offerId": "OFFER_UUID",
      "productId": "PRODUCT_UUID",
      "variantId": "VARIANT_UUID",
      "quantity": 1,
      "unitPrice": 3278
    }
  ],
  "breakdown": {
    "subtotal": 3278,
    "fees": [{ "label": "Processing fee", "amount": -21 }],
    "promotions": []
  },
  "optionals": [],
  "issues": []
}

Amounts are in cents. payout is what you are paid. issues lists what blocks execute or what the quote left out. Field details: Sell.

Execute

curl -X POST https://api.collectpure.com/execution/v3/sell/quotes/QUOTE_ID/execute \
  -H "x-api-key: YOUR_API_KEY"

{
  "status": "placed",
  "orderId": 989,
  "counterpartyOrderIds": [978],
  "payout": 4066
}

orderId is a purchase order, because Pure is buying from you. Fetch it at GET /orders/get-purchase-order/v1?id={orderId}.

Retries

Execute is idempotent by quote id. A repeated execute returns the first response, so retrying never places a second order. A quote places at most one order. Executing it again, even with a new Idempotency-Key, returns that order. Details: Errors and retries.

Changes from v2

v2	v3
Execute sends `expectedTotal` and `expectedOptionalFees`	Execute sends nothing; the quote holds both
Optionals by `selectedOptionalIds`	Optionals by `optionals` on the quote
`promotionCode` on execute	`promotionCode` on the quote
`adjustListings` / `confirmListingMismatch`	Not needed; execute does not check your listings
Many `errorCode` values	Four `errorCode` values; the cause is in `details.reason`

Endpoints

Method	Path	Role
`POST`	`/execution/v3/sell/quotes`	`stytch_admin`
`POST`	`/execution/v3/sell/quotes/{quoteId}/execute`	`stytch_admin`

​How it works

​Quote

​Execute

​Retries

​Changes from v2

​Endpoints

How it works

Quote

Execute

Retries

Changes from v2

Endpoints