---
title: "List of prices"
method: GET
path: "/api/v1/prices"
tags: ["Price"]
---

# List of prices

`GET /api/v1/prices`

Returns the list of prices

## Query parameters

- `page` number
- `limit` number
- `createdAt` DateFilterDto
  - `isnull` boolean — Returns null values
  - `notnull` boolean — Returns not null values
  - `gt` string, date-time — Returns values greater than the given date
  - `gte` string, date-time — Returns values greater than or equal to the given date
  - `lt` string, date-time — Returns values less than the given date
  - `lte` string, date-time — Returns values less than or equal to the given date
- `ids` string
- `visibility` string
- `isActive` boolean
- `type` 'one_time' | 'recurring' | 'streaming'
- `productId` string

## Response `200`

- object
  - `page` number, required — Page number. Starts from 1
  - `limit` number, required — Number of items per page
  - `count` number, required
  - `hasMore` boolean, required
  - `query` PaginationFilterDto
    - `page` number — Page number. Starts from 1
    - `limit` number — Number of items per page
    - `createdAt` DateFilterDto
      - `isnull` boolean — Returns null values
      - `notnull` boolean — Returns not null values
      - `gt` string, date-time — Returns values greater than the given date
      - `gte` string, date-time — Returns values greater than or equal to the given date
      - `lt` string, date-time — Returns values less than the given date
      - `lte` string, date-time — Returns values less than or equal to the given date
  - `data` object[], required
    - `id` string, required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `billingScheme` 'per_unit'
    - `currency` 'usdc' | 'usdt' | 'pyusd' | 'eurc' | 'brett' | 'dai' | 'btc' | 'eth' | 'matic' | 'bnb' | 'sol' | 'busd' | 'trx' | 'food' | 'bonk' | 'wif' | 'goat' | 'spx' | 'truf' | 'pengu', required
    - `productId` string, uuid, required — Product's id
    - `interval` 'day' | 'week' | 'month' | 'year'
    - `intervalCount` number — It is used to determine the frequency at which the subscription is billed. Only required for subscriptions
    - `isActive` boolean — Whether the price is currently active
    - `usageType` 'licensed'
    - `type` 'one_time' | 'recurring' | 'streaming', required
    - `unitAmount` integer — The unit amount in 8 decimals, represented as a whole integer. If not provided, the unit amount will be calculated from unit_amount_decimal.
    - `unitAmountDecimal` string
    - `customUnitMax` integer — The maximum amount that can be billed per unit for this price. Only if unit amount is not provided
    - `customUnitMin` integer — The minimum amount that can be billed per unit for this price. Only if unit amount is not provided
    - `customPreset` integer — The default amount to fill in the amount field for this price on checkout. Only if unit amount is not provided
    - `customUnitAmountSuggestions` string[] — Amount suggestions for this price. Only if unit amount is not provided
    - `product` PublicProductDto, required
      - `id` string, required
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `name` string, required — The name of the product. Displayed on the checkout page
      - `description` string — The description of the product. Displayed on the checkout page
      - `isActive` boolean — Whether the product is currently active
      - `images` string[] — The url of product images. Displayed on the checkout page
      - `publicImages` string[] — Product images with absolute public url
      - `unitLabel` string — The label of the unit of the product. Displayed on the checkout page
      - `url` string — The url of the product
      - `defaultPriceId` string, uuid — Product's default price id
      - `metadata` object — The metadata of the product
      - `visibility` string
    - `metadata` object — A set of key-value pairs that you can attach to an object. It can be useful for storing additional information about the object in a structured format.
    - `visibility` string
    - `nickname` string — A nickname for the price, not displayed to customer. Only visible in the dashboard

## Other responses

- `500`

---

[API](https://skmtc.net/copperx/apis/copperx-api-2.md) · [All operations](https://skmtc.net/copperx/apis/copperx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/copperx/copperx-api-2/revisions/c0bfbc37fb98/schema)