---
title: "List your organization's live listings"
method: GET
path: "/listings/get-listings/v2"
tags: ["Listings"]
---

# List your organization's live listings

`GET /listings/get-listings/v2`

## Request

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

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).

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

## Query parameters

- `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` number, nullable, required
    - `quantity` number, required
    - `premiumPercent` number, required
    - `premiumDollar` number, nullable, required
    - `type` string, required
    - `spotPremium` number, nullable, required
    - `spotPremiumDollar` number, nullable, required
    - `sellerNotes` string, nullable, required
    - `inventoryId` string, uuid, nullable, required
    - `active` boolean, required
    - `expiresAt` string, nullable, required
    - `createdAt` string, nullable, required
    - `updatedAt` string, 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)