Sandbox Environment

Pure provides a sandbox environment for testing the Execution API — both buying and selling — without using real money.

Sandbox API

Base URL: https://sandbox.api.collectpure.comAll sandbox requests use the same endpoints and schemas as production — just point to the sandbox base URL.

Sandbox API Keys

Generate a sandbox API key from your API Keys dashboard.Select Sandbox environment when creating the key.

Getting Started

Create a Sandbox API Key

Go to collectpure.com/dashboard/api-keys and create a new API key. Select the Sandbox environment.

Sandbox Data is Created For You

When you create a sandbox key, Pure automatically provisions test data for your organization — including products, listings, offers, and payment methods. You can start making API calls immediately.

Use the Sandbox Base URL

Point all your requests to https://sandbox.api.collectpure.com instead of the production URL. Use your sandbox API key in the x-api-key header.

Test the Full Flow

Fetch test listings or offers, create v2 quotes, review pricing and optionals, and execute orders — all in a safe testing environment with no real money involved.

Sandbox API keys cannot be used against the production API, and production keys cannot be used in sandbox. Make sure you’re using the correct key for the environment.

Sandbox Endpoints

The sandbox environment exposes additional endpoints to help you discover test data. These routes are registered only on the sandbox API deployment — they do not exist on the production base URL. Both sandbox discovery endpoints require stytch_member access. Responses use a { data: { ... } } envelope (no success field). Each response includes a total count for pagination.

`GET /sandbox/listings/get/v1` — Get test listings

Returns active listings available for testing. Use the listingId from the response to create buy quotes.

Parameter	Type	Default	Description
`limit`	number	50	Max listings to return (1–250)
`offset`	number	0	Number of listings to skip (pagination)

Response fields:

Field	Type	Description
`listingId`	string	The listing ID — pass this to the buy quote endpoint
`productId`	string	The product ID
`variantId`	string	The variant ID
`productTitle`	string	Product name
`sku`	string	Product SKU
`material`	string	Material (Gold, Silver, etc.)
`quantity`	number	Available quantity
`price`	number	Price in cents
`priceDollars`	number	Price in dollars
`spotPremium`	number	Premium over spot (%)
`spotPremiumDollar`	number	Premium over spot ($)
`expiresAt`	string	ISO 8601 listing expiration

The response also includes total — the total number of matching listings across all pages.

`GET /sandbox/offers/get/v1` — Get test offers

Returns active buy offers available for testing. Use the offerId from the response to create sell quotes.

Parameter	Type	Default	Description
`limit`	number	50	Max offers to return (1–250)
`offset`	number	0	Number of offers to skip (pagination)

Response fields:

Field	Type	Description
`offerId`	string	The offer ID — pass this to the sell quote endpoint
`productId`	string	The product ID
`variantId`	string	The variant ID
`buyerId`	string	The buyer organization ID for the offer
`productTitle`	string	Product name
`sku`	string	Product SKU
`material`	string	Material (Gold, Silver, etc.)
`quantity`	number	Available quantity
`price`	number	Price in cents
`priceDollars`	number	Price in dollars
`spotPremium`	number	Premium over spot (%)
`spotPremiumDollar`	number	Premium over spot ($)
`expiresAt`	string	ISO 8601 offer expiration

The response also includes total — the total number of matching offers across all pages.

Buy Example (v2)

# 1. Get your payment methods
curl -X GET https://sandbox.api.collectpure.com/execution/payment-methods/v1 \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 2. Fetch available test listings
curl -X GET "https://sandbox.api.collectpure.com/sandbox/listings/get/v1?limit=5" \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 3. Create a quote (pass Stripe payment method ID as paymentMethod)
curl -X POST https://sandbox.api.collectpure.com/execution/v2/buy/quotes \
  -H "x-api-key: YOUR_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "listingId": "LISTING_ID_FROM_STEP_2", "quantity": 1 }
    ],
    "paymentMethod": "pm_XXXXX"
  }'

# 4. (Optional) Inspect optionals
curl -X GET https://sandbox.api.collectpure.com/execution/v2/buy/quotes/QUOTE_ID_FROM_STEP_3/optionals \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 5. (Optional) Refresh quote with vault shipping selected
curl "https://sandbox.api.collectpure.com/execution/v2/buy/quotes/QUOTE_ID_FROM_STEP_3?selectedOptionalIds=vault_shipping&paymentMethod=pm_XXXXX" \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 6. Execute the buy (pass the total from the quote as expectedTotal)
curl -X POST https://sandbox.api.collectpure.com/execution/v2/buy/quotes/QUOTE_ID_FROM_STEP_3/execute \
  -H "x-api-key: YOUR_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedTotal": TOTAL_FROM_STEP_3,
    "paymentMethod": "pm_XXXXX",
    "selectedOptionalIds": ["vault_shipping"],
    "shipping": {
      "name": "John Doe",
      "line1": "123 Main St",
      "city": "Austin",
      "state": "TX",
      "postalCode": "78701",
      "country": "US"
    }
  }'

Omit shipping when vault shipping is selected and eligible.

Sell Example (v2)

# 1. Check your payout methods
curl -X GET https://sandbox.api.collectpure.com/execution/payout-methods/v1 \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 2. Fetch available test offers
curl -X GET "https://sandbox.api.collectpure.com/sandbox/offers/get/v1?limit=5" \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 3. Create a sell quote
curl -X POST https://sandbox.api.collectpure.com/execution/v2/sell/quotes \
  -H "x-api-key: YOUR_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "offerId": "OFFER_ID_FROM_STEP_2", "quantity": 1 }
    ]
  }'

# 4. (Optional) Refresh with instant payout selected
curl "https://sandbox.api.collectpure.com/execution/v2/sell/quotes/QUOTE_ID_FROM_STEP_3?selectedOptionalIds=instant_payout" \
  -H "x-api-key: YOUR_SANDBOX_KEY"

# 5. Execute the sell (pass the total and optional fees from the quote)
curl -X POST https://sandbox.api.collectpure.com/execution/v2/sell/quotes/QUOTE_ID_FROM_STEP_3/execute \
  -H "x-api-key: YOUR_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedTotal": TOTAL_FROM_STEP_4,
    "selectedOptionalIds": ["instant_payout"],
    "expectedOptionalFees": {
      "instant_payout": FEE_FROM_STEP_4
    }
  }'

Use GET /sandbox/listings/get/v1 to discover test listings for buy flows, and GET /sandbox/offers/get/v1 to discover test offers for sell flows. Pick any listingId or offerId from the response to use in your quote requests. See Checkout Optionals for add-on details.

Get Started

Authentication

Real-Time

Execution - Buy

Execution - Sell

Sandbox

Rate Limiting

Sandbox API

Sandbox API Keys

Getting Started

Sandbox Endpoints

`GET /sandbox/listings/get/v1` — Get test listings

`GET /sandbox/offers/get/v1` — Get test offers

Buy Example (v2)

Sell Example (v2)

Sandbox API

Sandbox API Keys

​Getting Started

​Sandbox Endpoints

​GET /sandbox/listings/get/v1 — Get test listings

​GET /sandbox/offers/get/v1 — Get test offers

​Buy Example (v2)

​Sell Example (v2)

Getting Started

Sandbox Endpoints

`GET /sandbox/listings/get/v1` — Get test listings

`GET /sandbox/offers/get/v1` — Get test offers

Buy Example (v2)

Sell Example (v2)