> ## 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. # Create a listing > Create a new orderbook listing for the authenticated organization. **Rate limit:** 120 requests burst, 60 requests/minute sustained. ## OpenAPI ````yaml /api-reference/openapi.json post /listings/create-listing/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: Purchase and sale order management for authenticated organizations - name: Marketplace description: Spot prices, marketplace statistics, shipping dates, and sitemap data - name: Organization description: Organization details and settings 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: 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: /listings/create-listing/v1: post: tags: - Listings summary: Create a listing description: |- Create a new orderbook listing for the authenticated organization. **Rate limit:** 120 requests burst, 60 requests/minute sustained. requestBody: required: true content: application/json: schema: 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)$ 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: 9007199254740991 type: type: string enum: - fixed_pricing - premium_percentage_pricing - premium_dollar_pricing price: description: Price in cents. Required for fixed_pricing type anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' premiumPercent: type: number minimum: 0 premiumDollar: description: Premium in cents type: integer minimum: 0 maximum: 9007199254740991 sellerNotes: type: string maxLength: 500 active: type: boolean expiresAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ inventoryId: 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)$ maxSpotPrice: description: Max spot price in cents anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' minSpotPrice: description: Min spot price in cents anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' required: - productId - variantId - quantity - type responses: '200': description: Default Response content: application/json: schema: type: object properties: success: type: boolean data: type: object properties: id: 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)$ 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)$ 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)$ price: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' expiresAt: type: string updatedAt: type: string createdAt: type: string sellerNotes: anyOf: - type: string - type: 'null' premiumPercent: type: number minimum: -140737488355328 maximum: 140737488355327 type: type: string enum: - fixed_pricing - premium_percentage_pricing - premium_dollar_pricing premiumDollar: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' spotPremium: anyOf: - type: number minimum: -140737488355328 maximum: 140737488355327 - type: 'null' quantity: type: integer minimum: -9007199254740991 maximum: 9007199254740991 active: type: boolean spotPremiumDollar: type: integer minimum: -9007199254740991 maximum: 9007199254740991 inventoryId: anyOf: - 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)$ - type: 'null' maxSpotPrice: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' minSpotPrice: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' expiryNotifiedAt: anyOf: - type: string - type: 'null' instantPayout: type: boolean required: - id - productId - variantId - price - expiresAt - updatedAt - createdAt - sellerNotes - premiumPercent - type - premiumDollar - spotPremium - quantity - active - spotPremiumDollar - inventoryId - maxSpotPrice - minSpotPrice - expiryNotifiedAt - instantPayout additionalProperties: false required: - success - data additionalProperties: false components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header description: API key for authentication ````