# Pure API Documentation

## Docs

- [Authentication](https://docs.collectpure.com/api-reference/authentication.md): Learn how to authenticate your API v2 requests
- [Create a buy quote](https://docs.collectpure.com/api-reference/execution--buy/create-a-buy-quote.md): Create a new buy quote with the specified items. Returns a quoteId and a pricing snapshot. The quote expires in 30 seconds.
- [Execute a buy order](https://docs.collectpure.com/api-reference/execution--buy/execute-a-buy-order.md): Execute a previously created buy quote. Validates the quote, charges payment, and creates orders. The quote must not be expired.
- [Get a buy quote](https://docs.collectpure.com/api-reference/execution--buy/get-a-buy-quote.md): Retrieve the current state and pricing of an existing buy quote. Returns a fresh pricing snapshot.
- [List payment methods](https://docs.collectpure.com/api-reference/execution--buy/list-payment-methods.md): List all Stripe payment methods for the authenticated organization, including which one is the default.
- [Create a sell quote](https://docs.collectpure.com/api-reference/execution--sell/create-a-sell-quote.md): Create a new sell quote with the specified items. Each item can reference an offer ID or a product+variant pair. Returns a quoteId, pricing breakdown, and available optionals (e.g. instant payout). The quote expires in 60 seconds.
- [Execute a sell order](https://docs.collectpure.com/api-reference/execution--sell/execute-a-sell-order.md): Execute a previously created sell quote. Validates the quote, creates sell orders, and initiates payout. The quote must not be expired.
- [Get a sell quote](https://docs.collectpure.com/api-reference/execution--sell/get-a-sell-quote.md): Retrieve the current state and pricing of an existing sell quote. Returns a fresh pricing snapshot. Optionally pass selectedOptionalIds to toggle add-on services like instant payout.
- [Get payout methods](https://docs.collectpure.com/api-reference/execution--sell/get-payout-methods.md): Retrieve the authenticated organization's payout configuration and instant payout credit information. Use the instant payout credit info to determine eligibility before selecting the instant payout optional in a sell quote.
- [Execution - Buy](https://docs.collectpure.com/api-reference/execution-buy.md): Programmatically buy precious metals through the Pure marketplace
- [Sandbox Environment](https://docs.collectpure.com/api-reference/execution-sandbox.md): Test the Execution API without using real money
- [Execution - Sell](https://docs.collectpure.com/api-reference/execution-sell.md): Programmatically sell precious metals through the Pure marketplace
- [Introduction](https://docs.collectpure.com/api-reference/introduction.md): Welcome to the Pure Public API Documentation
- [Get inventory statistics for your organization](https://docs.collectpure.com/api-reference/inventory/get-inventory-statistics-for-your-organization.md): Retrieve aggregate statistics about the authenticated organization's inventory, including total items, quantities, cost basis, and unique product count.
- [List your organization's inventory](https://docs.collectpure.com/api-reference/inventory/list-your-organizations-inventory.md): Retrieve inventory items for the authenticated organization with optional filtering by product ID. Results include related product and variant details.
- [List your organization's orderbook listings](https://docs.collectpure.com/api-reference/listings-legacy/list-your-organizations-orderbook-listings.md): Retrieve orderbook listings for the authenticated organization with optional filtering by active status and product ID. Results include related product and variant details.
- [Create a listing](https://docs.collectpure.com/api-reference/listings/create-a-listing.md): Create a new orderbook listing for the authenticated organization.
- [Deactivate a listing](https://docs.collectpure.com/api-reference/listings/deactivate-a-listing.md): Deactivate an orderbook listing owned by the authenticated organization. This sets the listing's active status to false rather than permanently deleting it.
- [Get listing statistics for your organization](https://docs.collectpure.com/api-reference/listings/get-listing-statistics-for-your-organization.md): Retrieve aggregate statistics about the authenticated organization's orderbook listings, including counts, quantities, and total value.
- [List your organization's live listings](https://docs.collectpure.com/api-reference/listings/list-your-organizations-live-listings.md): Retrieve live orderbook listings for the authenticated organization. Only returns active, non-expired listings with valid pricing from trading-enabled organizations (via `orderbook_listing_live` view).
- [Update a listing](https://docs.collectpure.com/api-reference/listings/update-a-listing.md): Update fields on an orderbook listing owned by the authenticated organization. Only the provided fields will be updated.
- [Get platform-wide marketplace statistics](https://docs.collectpure.com/api-reference/marketplace/get-platform-wide-marketplace-statistics.md): Retrieve aggregate marketplace statistics including total ask/bid amounts, listing/offer counts, and product counts. Stats are recalculated every minute.
- [Get recommended shipping date](https://docs.collectpure.com/api-reference/marketplace/get-recommended-shipping-date.md): Retrieve the recommended shipping date for the product. This endpoint returns the two day and overnight shipping dates.
- [Get sitemap products](https://docs.collectpure.com/api-reference/marketplace/get-sitemap-products.md): Retrieve all products for the sitemap. This endpoint returns the sku and updatedAt for all products.
- [Get spot price](https://docs.collectpure.com/api-reference/marketplace/get-spot-price.md): Retrieve current spot prices for all precious metals. This endpoint returns the current bid/ask prices, market status, and price changes for all supported materials.
- [List your organization's orderbook offers](https://docs.collectpure.com/api-reference/offers-legacy/list-your-organizations-orderbook-offers.md): Retrieve orderbook offers (bids) for the authenticated organization with optional filtering by active status and product ID. Results include related product and variant details.
- [Create an offer](https://docs.collectpure.com/api-reference/offers/create-an-offer.md): Create a new orderbook offer (bid) for the authenticated organization.
- [Deactivate an offer](https://docs.collectpure.com/api-reference/offers/deactivate-an-offer.md): Deactivate an orderbook offer owned by the authenticated organization. This sets the offer's active status to false rather than permanently deleting it.
- [Get offer statistics for your organization](https://docs.collectpure.com/api-reference/offers/get-offer-statistics-for-your-organization.md): Retrieve aggregate statistics about the authenticated organization's orderbook offers (bids), including counts, quantities, and total value.
- [List your organization's live offers](https://docs.collectpure.com/api-reference/offers/list-your-organizations-live-offers.md): Retrieve live orderbook offers for the authenticated organization. Only returns active, non-expired offers with valid pricing from trading-enabled organizations (via `orderbook_offer_live` view).
- [Update an offer](https://docs.collectpure.com/api-reference/offers/update-an-offer.md): Update fields on an orderbook offer owned by the authenticated organization. Only the provided fields will be updated.
- [List purchase orders](https://docs.collectpure.com/api-reference/orders/list-purchase-orders.md): List the purchase orders for the authenticated organization. Results are scoped to the API key's organization — you cannot access another organization's orders.
- [List sale orders](https://docs.collectpure.com/api-reference/orders/list-sale-orders.md): List the sale orders for the authenticated organization. Results are scoped to the API key's organization — you cannot access another organization's orders.
- [Get organization details](https://docs.collectpure.com/api-reference/organization/get-organization-details.md): Get the organization details associated with the authenticated API key. Sensitive fields such as access tokens and internal IDs are excluded.
- [Update organization settings](https://docs.collectpure.com/api-reference/organization/update-organization-settings.md): Update one or more settings for the authenticated organization. Only the provided fields will be modified. Supports vacation mode, payout method, and electronic check details.
- [Get product attributes](https://docs.collectpure.com/api-reference/products-legacy/get-product-attributes.md): Retrieve all product attributes
- [Get product options](https://docs.collectpure.com/api-reference/products-legacy/get-product-options.md): Retrieve all product options with images, categories, and variants
- [Get product order book](https://docs.collectpure.com/api-reference/products-legacy/get-product-order-book.md): Retrieve the order book for a product
- [Get products by IDs](https://docs.collectpure.com/api-reference/products-legacy/get-products-by-ids.md): Retrieve products by their IDs with variants, offers, and listings
- [Get products with filtering](https://docs.collectpure.com/api-reference/products-legacy/get-products-with-filtering.md): Retrieve products filtered by material and attributes, with variants, offers, and listings. Returns paginated results.
- [Search products](https://docs.collectpure.com/api-reference/products-legacy/search-products.md): Search for products. When no query is provided, returns all products with pagination.
- [Get certificate providers](https://docs.collectpure.com/api-reference/products/get-certificate-providers.md): Retrieve all product certificate providers
- [Get enriched product details](https://docs.collectpure.com/api-reference/products/get-enriched-product-details.md): Retrieve a single product with all variants (including best offer/listing and order book per variant) and recent activity.
- [Get live orderbook for a product](https://docs.collectpure.com/api-reference/products/get-live-orderbook-for-a-product.md): Retrieve the live orderbook for a product across all variants. Returns active listings and offers from the `orderbook_listing_live` and `orderbook_offer_live` views (already filtered to active, non-expired, trading-enabled organizations).
- [Get product activity](https://docs.collectpure.com/api-reference/products/get-product-activity.md): Retrieve all product activity
- [Get product analytics](https://docs.collectpure.com/api-reference/products/get-product-analytics.md): Retrieve all product analytics
- [Get product catalog metadata](https://docs.collectpure.com/api-reference/products/get-product-catalog-metadata.md): Retrieve all product catalog metadata in a single request — categories, subcategories, manufacturers, materials, attributes, and certificate providers.
- [Get product categories](https://docs.collectpure.com/api-reference/products/get-product-categories.md): Retrieve all product categories
- [Get product manufacturers](https://docs.collectpure.com/api-reference/products/get-product-manufacturers.md): Retrieve all product manufacturers
- [Get product materials](https://docs.collectpure.com/api-reference/products/get-product-materials.md): Retrieve all product materials
- [Get product subcategories](https://docs.collectpure.com/api-reference/products/get-product-subcategories.md): Retrieve all product subcategories
- [Search products](https://docs.collectpure.com/api-reference/products/search-products.md): Search and browse products with full-text search, filtering, and facets. Returns enriched product data with variants hydrated from the database.
- [Quickstart](https://docs.collectpure.com/api-reference/quickstart.md): Start using the Pure API v2 in minutes
- [Marketplace API healthcheck](https://docs.collectpure.com/api-reference/root/marketplace-api-healthcheck.md): Returns the health status of the Marketplace API.
- [Get test listings](https://docs.collectpure.com/api-reference/sandbox/get-test-listings.md): Retrieve active listings for sandbox testing. Only available in non-production environments.
- [Get test offers](https://docs.collectpure.com/api-reference/sandbox/get-test-offers.md): Retrieve active offers for sandbox testing. Only available in non-production environments.
- [Development](https://docs.collectpure.com/development.md): Best practices for integrating with the Pure API
- [Rate Limiting](https://docs.collectpure.com/rate-limiting.md): Understand how the Pure API enforces rate limits using a token bucket algorithm
- [WebSocket Streams](https://docs.collectpure.com/websockets.md): Real-time orderbook data via WebSocket — subscribe to live listing and offer events

## OpenAPI Specs

- [openapi](https://docs.collectpure.com/api-reference/openapi.json)

## Optional

- [Website](https://www.collectpure.com)
- [Blog](https://www.collectpure.com/blog)