Listar eventos

Lista events em ordem decrescente de criação. Events não têm expiração automática; registros antigos continuam disponíveis na listagem.

Filtros

string

Filtra por tipo de evento, ex.: customer.updated.

string

Filtra pelo tipo do recurso afetado, ex.: subscription, checkout.session.

Filtra pelos eventos de um recurso específico, pelo ID público dele (ex.: sub_UsVYW1H9wWd7iaFt). Útil para montar a linha do tempo de um recurso.

boolean

false lista os events que pelo menos um endpoint de webhook ainda não recebeu (a última tentativa falhou). true lista os que todos os endpoints responderam 2xx, ou que não tinham endpoint para receber. É o jeito de descobrir pela API que o seu endpoint está falhando: cada event traz em webhook_deliveries o status HTTP da última tentativa por endpoint. Combine com created_at[gte] para olhar só o período que interessa.

string

Eventos criados a partir do timestamp informado (ISO 8601). Também aceita created_at[gt], created_at[lte] e created_at[lt].

integer

Quantidade de itens, de 1 a 100. Padrão 10.

string

Cursor para a próxima página (ID de um event).

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

curl -X GET "https://api.chargefy.io/v1/events?delivery_success=false&limit=20" \
  -H "Authorization: Bearer {{API_KEY}}"

200

{
  "object": "list",
  "data": [
    {
      "id": "evt_cptxUxXUAVT9APY8",
      "object": "event",
      "created_at": "2026-05-27T14:09:27Z",
      "data": {
        "object": {
          "id": "cus_5hK4wGcGNv3zWP6W",
          "object": "customer",
          "billing_address": null,
          "billing_name": null,
          "created_at": "2026-05-27T14:09:20Z",
          "document": null,
          "document_type": null,
          "email": "[email protected]",
          "livemode": true,
          "metadata": {},
          "name": "Cliente",
          "phone": null,
          "trade_name": null,
          "updated_at": "2026-05-27T14:09:27Z"
        },
        "previous_attributes": {
          "name": "Nome anterior"
        }
      },
      "livemode": true,
      "organization": "org_2iR31EzUBygEbMbD",
      "pending_webhooks": 1,
      "request": {
        "id": "req_kGkDjMA1eBrQVGAE"
      },
      "type": "customer.updated",
      "webhook_deliveries": [
        {
          "attempted_at": "2026-05-27T14:39:31Z",
          "http_code": 500,
          "status": "failed",
          "webhook_endpoint": "we_9wQpX3sT7mK2rV5L"
        }
      ]
    }
  ],
  "has_more": false,
  "url": "/v1/events"
}

Erros comuns

400

{
  "error": {
    "code": "invalid_request",
    "message": "limit must be between 1 and 100.",
    "param": "limit",
    "type": "invalid_request_error"
  }
}

400

{
  "error": {
    "code": "invalid_request",
    "message": "delivery_success must be true or false.",
    "param": "delivery_success",
    "type": "invalid_request_error"
  }
}

401

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API Key provided: ch_live_***************************************9f2c",
    "type": "authentication_error"
  }
}

Fundamentos da API

MCP

Objetos de sistema

Webhooks e eventos

SDKs

Filtros

Erros comuns

​Filtros

​Erros comuns

Filtros

Erros comuns