---
title: "List Prices"
method: GET
path: "/prices"
tags: ["Prices"]
---

# List Prices

`GET /prices`

## Request

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

Lists the prices of one product, newest first, one page at a time.

`productId` is required. A product of another merchant account is reported as not found.

To get the next page, send the `nextCursor` of the response as `cursor`. When there are no more items, the response has no `nextCursor`. The last page can still carry one, and the next call then returns no items.

A price you just created can take a moment to appear in the list. [Get Price](https://docs.monei.com/apis/rest/prices-get/) returns it at once.

## Query parameters

- `productId` string, uuid, required: Unique identifier for the product.
- `limit` integer
- `cursor` string

## Response `200`

One page of prices, newest first

- PriceList
  - `items` Price[], required: The prices in this page, newest first.
    - `id` string, uuid, required: Unique identifier for the price.
    - `productId` string, uuid, required: The [product](https://docs.monei.com/apis/rest/products-create/) of the price. It cannot change after the price is created.
    - `currency` string, required: Three-letter [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Must be a supported currency.
    - `unitAmount` integer, required: The amount charged for each billing period. A positive integer in the smallest currency unit (for example, 1990 cents to charge 19.90 EUR).
    - `type` string, required: How the price bills. `RECURRING` is the only value today, and the default. Treat the set as open: more values can be added later.
    - `recurring` PriceRecurring: The billing period of a `RECURRING` price. A subscription created from the price copies these values.
      - `interval` 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year', required: The unit of the billing period. `minute` and `hour` are accepted in test mode only.
      - `intervalCount` integer, required: Number of intervals between payments. The billing period cannot be longer than one year.
      - `trialPeriodDays` integer: Number of trial days of a subscription created from the price.
    - `active` boolean, required: Whether the price is active. An inactive price cannot start a subscription, and a subscription cannot switch to it. Prices are never deleted: set `active` to `false` to archive one. Subscriptions that already use it keep their copy of its values.
    - `nickname` string: An internal label of the price. Buyers never see it.
    - `metadata` Metadata: A set of key-value pairs that you can attach to a resource. This can be useful for storing additional information about the resource in a structured format.
    - `createdAt` integer, required: Time at which the resource was created. Measured in seconds since the Unix epoch.
    - `updatedAt` integer: Time at which the resource updated last time. Measured in seconds since the Unix epoch.
  - `nextCursor` string: Pass this value as `cursor` to get the next page. Absent when there are no more items. The last page can still carry it, and the next call then returns no items.

## Other responses

- `400`: The request is incorrect or could not be processed
- `401`: Unauthorized error. Please check your auth credentials
- `404`: The specified resource was not found
- `422`: The request was well-formed but could not be processed due to semantic errors
- `500`: Unexpected server error
- `503`: The service is temporarily unavailable

## Changes

- **2026-10-29** `50bc7df2aa43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monei/apis/monei-api-v1/changes/prices/get.md)

---

[API](https://skmtc.dev/monei/apis/monei-api-v1.md) - [All operations](https://skmtc.dev/monei/apis/monei-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/monei/apis/monei-api-v1/revisions/50bc7df2aa43?raw)