---
title: "Get products with filtering"
method: GET
path: "/products/get-products/v2"
tags: ["Products (Legacy)"]
---

# Get products with filtering

`GET /products/get-products/v2`

## Request

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

Retrieve products filtered by material and attributes, with variants, offers, and listings. Returns paginated results.

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

## Query parameters

- `material` string
- `attributeIds` string
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `title` string, required
    - `purity` string, required
    - `weight` string, required
    - `weightGrams` number, required
    - `sku` string, required
    - `isCertified` boolean, required
    - `isIra` boolean, required
    - `material` string, required
    - `attributes` string[], required
    - `images` string[], required
    - `manufacturer` object, nullable, required
      - `title` string, required
      - `images` string[], required
      - `isEsg` boolean, required
    - `category` object, nullable, required
      - `title` string, required
      - `isNumismatic` boolean, required
    - `subCategory` object, nullable, required
      - `title` string, required
      - `premiumCalculationType` string, required
    - `certificateProvider` object, nullable, required
      - `title` string, nullable, required
    - `variants` object[], required
      - `title` string, nullable, required
      - `highestOffer` object, nullable, required
        - `id` string, uuid, required
        - `price` number, required
        - `quantity` number, required
        - `spotPremium` number, required
        - `spotPremiumDollar` number, required
        - `expiresAt` string, required
        - `createdAt` string, required
        - `updatedAt` string, required
      - `lowestListing` object, nullable, required
        - `id` string, uuid, required
        - `price` number, required
        - `quantity` number, required
        - `spotPremium` number, required
        - `spotPremiumDollar` number, required
        - `expiresAt` string, required
        - `createdAt` string, required
        - `updatedAt` string, required
      - `images` string[], nullable, required
  - `total` number, required
  - `limit` number, required
  - `offset` 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)