Prices

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 returns it at once.

get/prices

Request

Query parameters

productIdstring uuid required

Unique identifier for the product.

Example:8f2c6d1a-4b3e-4f7a-9d2c-1e5b7a9c3f60

The product whose prices to list.

limitinteger

Number of items in one page, from 1 to 100.

cursorstring

The nextCursor of the previous page. Omit it to get the first page.

Response

One page of prices, newest first

nextCursorstring

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.

Example response

{
  "items": [
    {
      "id": "3c5a1f8e-2b7d-4e9a-9c41-7d2e6b0f5a13",
      "productId": "8f2c6d1a-4b3e-4f7a-9d2c-1e5b7a9c3f60",
      "currency": "EUR",
      "unitAmount": 1990,
      "type": "RECURRING",
      "recurring": {
        "interval": "month",
        "intervalCount": 1,
        "trialPeriodDays": 7
      },
      "active": true,
      "nickname": "Monthly",
      "metadata": {
        "systemId": "12345"
      },
      "createdAt": 1636366897,
      "updatedAt": 1636366897
    }
  ],
  "nextCursor": "eyJpZCI6IjhmMmM2ZDFhIiwiY3JlYXRlZEF0IjoxNzYxMjE0NDAwfQ"
}

Changes