Skip to main content
curl -X GET "https://api.chargefy.io/v1/prices?product_id=prod_123&limit=20" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "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"
}
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.

​
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

​
limit
integer
default:"10"
Quantidade de itens por página. Entre 1 e 100.
​
starting_after
string
ID do preço que delimita o início da próxima página (exclusivo).
​
ending_before
string
ID do preço que delimita o fim da página anterior (exclusivo).
​
product_id
string
Filtra preços de um produto específico.
​
is_active
boolean | string
Quando omitido, retorna apenas is_active=true. Envie false para arquivados ou all para incluir ambos.
curl -X GET "https://api.chargefy.io/v1/prices?product_id=prod_123&limit=20" \
  -H "Authorization: Bearer {{API_KEY}}"

​
Resposta

200 OK com o envelope canônico de listagem.
CampoTipoObservação
objectstringSempre "list"
dataarrayCada item é um objeto price completo
has_morebooleantrue quando há próxima página
urlstringPath relativo (/v1/prices)
{
  "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"
}