# List all prices

Retrieves a paginated list of all prices for the authenticated account. Supports pagination and search functionality.

Endpoint: GET /prices
Version: 1.0

## Query parameters:

  - `search` (string)
    {"active":true, 
      "inclusive":false,
      "currency":"usd",
      "type":"recurring|one_time",
      "product":"prod_5S8Wt9GNRDxZ7Tjy6g9KKBb5",
      "created[gt|gte|lt|lte]":1766066322}

  - `page` (number)

  - `take` (number)

## Header parameters:

  - `cc-api-key` (string, required)
    Chaching API Key

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string, required)
    Unique identifier for the object.
    Example: "price_1SGKTmDZYOQH9uHk1vaSxPKa"

  - `data.object` (string, required)
    String representing the object’s type.
    Enum: "price"

  - `data.active` (boolean, required)
    Indicates whether the object is active.
    Example: true

  - `data.created` (number, required)
    Time at which the object was created. Measured in seconds since the Unix epoch
    Example: 1760018761

  - `data.currency` (string, required)
    Three-letter ISO currency code, in uppercase
    Example: "USD"

  - `data.description` (string,null)
    Customer-facing price description
    Example: "Premium Plan - Monthly"

  - `data.product` (string, required)
    ID of the product this price is associated with

  - `data.recurring` (object,null, required)
    The recurring components of a price such as interval and interval_count. Null if the price is not recurring.
    Example: {"interval":"month","interval_count":1}

  - `data.recurring.interval` (string, required)
    Billing frequency
    Enum: "day", "week", "month", "year"

  - `data.recurring.interval_count` (number, required)
    Number of intervals between billings
    Example: 1

  - `data.tax_behavior` (string, required)
    The tax behavior of the product.
    Enum: "exclusive", "inclusive"

  - `data.type` (string, required)
    One of one_time or recurring depending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
    Enum: "recurring", "one_time"

  - `data.unit_amount` (number,null, required)
    The unit amount in cents to be charged, represented as a whole integer if possible.
    Example: 1000

  - `data.unit_amount_decimal` (string,null, required)
    Same as unit_amount
    Example: "1000"

  - `data.link` (string,null)
    Payment link associated with the price for hosted pages or other off-session payments.

  - `meta` (object)

  - `meta.page` (number)
    Example: 1

  - `meta.take` (number)
    Example: 10

  - `meta.itemsTotal` (number)
    Example: 50

  - `meta.pagesTotal` (number)
    Example: 5


## Response 400 fields