Sign in
Prices

Find one Price

Retrieve a Price by its ID

get/prices/{id}

Path parameters

idstring required

Response

OK

createdAtstring date-time required

The date and time when the entity was created.

updatedAtstring date-time nullable required

The date and time when the entity was last updated.

metadataobject nullable

Metadata used by merchants to store additional information about the entity.

idstring required

ID of the price

type'one_time' | 'recurring' required

Type of the price

activeboolean required

Indicates if the price is currently active. Inactive prices will be hidden from the dashboard, but can still be used in the API.

namestring

Name of the price. Only available from the dashboard or the API using a secret key.

amountnumber required

Amount of the price in minor units (e.g., cents)

quantitynumber required

Number of units this price represents. The amount covers all of them, so a line item referencing this price gets this quantity at a per-unit amount of amount / quantity.

currency'usd' | 'eur' | 'gbp' | 'cad' | 'aud' | 'pln' | 'czk' | 'sek' | 'dkk' required

Currency of the price

Example response

{
  "createdAt": "2024-02-18T12:00:00Z",
  "updatedAt": "2024-02-21T12:15:00Z",
  "metadata": {
    "key1": "value1",
    "key2": "value2"
  },
  "id": "price_2R4e2xDqbww8ewmkIYWE1A6Zcfp",
  "type": "recurring",
  "active": true,
  "name": "My Digital Subscription",
  "amount": 1500,
  "quantity": 1,
  "currency": "usd",
  "product": {
    "createdAt": "2024-02-18T12:00:00Z",
    "updatedAt": "2024-02-21T12:15:00Z",
    "metadata": {
      "key1": "value1",
      "key2": "value2"
    },
    "id": "prod_2QC7PqoUeOxQEWscJJt6B3PkvyL",
    "active": true,
    "name": "My product",
    "description": "Best selling product",
    "statementDescriptor": "Face Yoga subscription",
    "category": "digital",
    "sku": "FY-YOGA-MAT-01"
  },
  "billingSchedule": {
    "createdAt": "2024-02-18T12:00:00Z",
    "updatedAt": "2024-02-21T12:15:00Z",
    "metadata": {
      "key1": "value1",
      "key2": "value2"
    },
    "id": "bsch_2QC7PqoUeOxQEWscJJt6B3PkvyL",
    "currency": "usd",
    "cycleDefinitions": [
      {
        "createdAt": "2024-02-18T12:00:00Z",
        "updatedAt": "2024-02-21T12:15:00Z",
        "metadata": {
          "key1": "value1",
          "key2": "value2"
        },
        "position": 1,
        "amount": 1500,
        "currency": "usd"
      }
    ]
  },
  "recurringSchedule": {
    "intervalUnit": "month",
    "intervalCount": 1,
    "trial": {
      "intervalUnit": "day",
      "intervalCount": 7,
      "amount": 199
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.