> ## 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.

# Listar endpoints de webhooks

> Lista os endpoints de webhook da organização.

Lista os `webhook_endpoints` da organização no ambiente da API key, do mais
recente para o mais antigo. As respostas **não incluem o `secret`**.

## Autenticação

Use a API key da organização com escopo `read`. A API key de plataforma não
gerencia endpoints e o header `Organization` não é aceito neste recurso.

## Parâmetros de query

<ParamField query="ending_before" type="string">
  Cursor para a página anterior: retorna endpoints criados depois do ID
  informado.
</ParamField>

<ParamField query="events_from" type="string">
  Filtra pelo fluxo de eventos: `organization` ou `platform`.
</ParamField>

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

<ParamField query="starting_after" type="string">
  Cursor para a próxima página: retorna endpoints criados antes do ID
  informado.
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":"css-variables"}
  curl "https://api.chargefy.io/v1/webhook-endpoints?limit=10" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Resposta

`200 OK` com o envelope de listagem. `data` traz objetos
[`webhook_endpoint`](/api-reference/webhook-endpoints/object) completos.

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "object": "list",
    "data": [
      {
        "id": "we_gry4MToxnzbQ81cp",
        "object": "webhook_endpoint",
        "created_at": "2026-07-19T12:00:00Z",
        "events": [
          "payment.intent.succeeded",
          "charge.refunded"
        ],
        "events_from": "organization",
        "livemode": true,
        "metadata": {},
        "name": "Servidor principal",
        "updated_at": null,
        "url": "https://meusite.com/webhooks/chargefy"
      }
    ],
    "has_more": false,
    "url": "/v1/webhook-endpoints"
  }
  ```

  ```json 400 theme={"theme":"css-variables"}
  {
    "error": {
      "code": "invalid_request",
      "message": "events_from must be \"organization\" or \"platform\"",
      "param": "events_from",
      "type": "invalid_request_error"
    }
  }
  ```

  ```json 401 theme={"theme":"css-variables"}
  {
    "error": {
      "code": "authentication_failed",
      "message": "Unauthorized — invalid api key",
      "type": "authentication_error"
    }
  }
  ```
</ResponseExample>

## Erros

| Status | Quando                                                     |
| ------ | ---------------------------------------------------------- |
| `400`  | `events_from` com valor fora de `organization`/`platform`. |
| `401`  | Credencial ausente, inválida, revogada ou expirada.        |