Skip to main content
curl -X GET "https://api.chargefy.io/v1/events?type=customer.updated&limit=10" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "object": "list",
  "data": [
    {
      "id": "evt_123",
      "object": "event",
      "created_at": "2026-05-27T14:09:27Z",
      "data": {
        "object": {
          "id": "cus_123",
          "object": "customer",
          "created_at": "2026-05-27T14:09:20Z",
          "email": "ana@example.com",
          "livemode": true,
          "metadata": {},
          "name": "Ana Souza"
        },
        "previous_attributes": {
          "name": "Ana"
        }
      },
      "livemode": true,
      "organization": "org_123",
      "request": {
        "id": "req_123"
      },
      "type": "customer.updated"
    }
  ],
  "has_more": false,
  "url": "/v1/events"
}
Lista events em ordem decrescente de criação. Events ficam disponíveis por 30 dias; eventos mais antigos não aparecem na listagem.

​
Filtros

​
type
string
Filtra por tipo de evento, ex.: customer.updated.
​
object_type
string
Filtra pelo tipo do recurso afetado, ex.: subscription, checkout.session.
​
related_object
string
Filtra pelos eventos de um recurso específico, pelo ID público dele (ex.: sub_123). Útil para montar a linha do tempo de um recurso.
​
created_at[gte]
string
Eventos criados a partir do timestamp informado (ISO 8601). Também aceita created_at[gt], created_at[lte] e created_at[lt].
​
limit
integer
Quantidade de itens, de 1 a 100. Padrão 10.
​
starting_after
string
Cursor para a próxima página (ID de um event).
​
ending_before
string
Cursor para a página anterior (ID de um event).
curl -X GET "https://api.chargefy.io/v1/events?type=customer.updated&limit=10" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "object": "list",
  "data": [
    {
      "id": "evt_123",
      "object": "event",
      "created_at": "2026-05-27T14:09:27Z",
      "data": {
        "object": {
          "id": "cus_123",
          "object": "customer",
          "created_at": "2026-05-27T14:09:20Z",
          "email": "ana@example.com",
          "livemode": true,
          "metadata": {},
          "name": "Ana Souza"
        },
        "previous_attributes": {
          "name": "Ana"
        }
      },
      "livemode": true,
      "organization": "org_123",
      "request": {
        "id": "req_123"
      },
      "type": "customer.updated"
    }
  ],
  "has_more": false,
  "url": "/v1/events"
}