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

{
  "object": "list",
  "data": [
    {
      "id": "prod_123",
      "object": "product",
      "created_at": "2026-05-16T14:09:27Z",
      "default_price": "price_123",
      "description": "Acesso completo",
      "image_url": null,
      "is_active": true,
      "is_tax_applicable": true,
      "livemode": true,
      "metadata": {
        "reference_id": "sku_pro"
      },
      "name": "Plano Pro",
      "prices": [],
      "updated_at": null
    }
  ],
  "has_more": true,
  "url": "/v1/products"
}
Lista produtos 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/products/: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 produto que delimita o início da próxima página (exclusivo).
​
ending_before
string
ID do produto que delimita o fim da página anterior (exclusivo).
​
is_active
boolean | string
Quando omitido, retorna apenas is_active=true. Envie false para arquivados ou all para incluir ambos.
​
query
string
Busca parcial por name (case-insensitive).
curl -X GET "https://api.chargefy.io/v1/products?limit=20&starting_after=prod_123" \
  -H "Authorization: Bearer {{API_KEY}}"

​
Resposta

200 OK com o envelope canônico de listagem.
CampoTipoObservação
objectstringSempre "list"
dataarrayCada item é um objeto product completo
has_morebooleantrue quando há próxima página
urlstringPath relativo (/v1/products)
{
  "object": "list",
  "data": [
    {
      "id": "prod_123",
      "object": "product",
      "created_at": "2026-05-16T14:09:27Z",
      "default_price": "price_123",
      "description": "Acesso completo",
      "image_url": null,
      "is_active": true,
      "is_tax_applicable": true,
      "livemode": true,
      "metadata": {
        "reference_id": "sku_pro"
      },
      "name": "Plano Pro",
      "prices": [],
      "updated_at": null
    }
  ],
  "has_more": true,
  "url": "/v1/products"
}