> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Prices

> Lista preços.

Lista preços vinculados à organização que está atuando, ordenados por
`created_at` decrescente. Use `starting_after`/`ending_before` para paginar.
Cada item vem no mesmo shape de
[`GET /v1/prices/:id`](/api-reference/prices/get#resposta).

## Autenticação

A API key da própria organização atua diretamente. A API key de plataforma exige o
header `Organization: <organization_id>` apontando para uma organização
conectada ativa.

## Parâmetros de query

<ParamField query="limit" type="integer" default="10">
  Quantidade de itens por página. Entre `1` e `100`.
</ParamField>

<ParamField query="starting_after" type="string">
  ID do preço que delimita o início da próxima página (exclusivo).
</ParamField>

<ParamField query="ending_before" type="string">
  ID do preço que delimita o fim da página anterior (exclusivo).
</ParamField>

<ParamField query="product_id" type="string">
  Filtra preços de um produto específico.
</ParamField>

<ParamField query="is_active" type="boolean | string">
  Quando omitido, retorna apenas `is_active=true`. Envie `false` para arquivados
  ou `all` para incluir ambos.
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X GET "https://api.chargefy.io/v1/prices?product_id=prod_123&limit=20" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Resposta

`200 OK` com o envelope canônico de listagem.

| Campo      | Tipo      | Observação                             |
| ---------- | --------- | -------------------------------------- |
| `object`   | `string`  | Sempre `"list"`                        |
| `data`     | `array`   | Cada item é um objeto `price` completo |
| `has_more` | `boolean` | `true` quando há próxima página        |
| `url`      | `string`  | Path relativo (`/v1/prices`)           |

<ResponseExample>
  ```json 200 theme={}
  {
    "object": "list",
    "data": [
      {
        "id": "price_123",
        "object": "price",
        "created_at": "2026-05-16T14:09:27Z",
        "currency": "brl",
        "is_active": true,
        "livemode": true,
        "metadata": {},
        "name": "Mensal",
        "product": "prod_123",
        "recurring": {
          "interval": "month",
          "interval_count": 1,
          "trial_period_days": null,
          "usage_type": "licensed"
        },
        "tax_behavior": "unspecified",
        "type": "recurring",
        "unit_amount": 9990,
        "updated_at": null
      }
    ],
    "has_more": false,
    "url": "/v1/prices"
  }
  ```
</ResponseExample>