---
title: "List your organization's orderbook listings"
method: GET
path: "/listings/get-listings/v1"
tags: ["Listings (Legacy)"]
---

# List your organization's orderbook listings

`GET /listings/get-listings/v1`

## Request

- Base URL: `https://api.collectpure.com`
- URL: `https://api.collectpure.com/listings/get-listings/v1`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/collectpure/apis/pure-public-api/docs/listings/get-listings/v1/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve orderbook listings for the authenticated organization with optional filtering by active status and product ID. Results include related product and variant details.

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

## Query parameters

- `active` 'true' | 'false'
- `productId` string, uuid
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `productId` string, uuid, required
    - `variantId` string, uuid, required
    - `price` integer, nullable, required
    - `expiresAt` string, required
    - `updatedAt` string, required
    - `createdAt` string, required
    - `sellerNotes` string, nullable, required
    - `premiumPercent` number, required
    - `type` 'fixed_pricing' | 'premium_percentage_pricing' | 'premium_dollar_pricing', required
    - `premiumDollar` integer, nullable, required
    - `spotPremium` number, nullable, required
    - `quantity` integer, required
    - `active` boolean, required
    - `spotPremiumDollar` integer, required
    - `inventoryId` string, uuid, nullable, required
    - `product` object, nullable, required
      - `id` string, uuid, required
      - `title` string, required
      - `sku` string, required
      - `material` string, required
    - `variant` object, nullable, required
      - `id` string, uuid, required
      - `title` string, required
  - `total` number, required

---

[API](https://skmtc.dev/collectpure/apis/pure-public-api.md) - [All operations](https://skmtc.dev/collectpure/apis/pure-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/collectpure/apis/pure-public-api/revisions/ed6a1fe27572?raw)