> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar webhooks

> Obtén todos los endpoints de webhook registrados en tu cuenta, con la opción de filtrar por estado para encontrar webhooks activos, deshabilitados o eliminados.

Usa este endpoint para listar los endpoints de webhook registrados en tu cuenta. Puedes filtrar por estado para ver solo los webhooks activos, deshabilitados o eliminados previamente. La respuesta contiene como máximo 100 webhooks, ordenados del actualizado más recientemente al más antiguo. Cada resultado incluye el `webhookId`, el tipo de evento, la URL de callback y la clave pública que se usa para verificar la firma.

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` con un token de negocio de `GET /v2/token/generate`.

## Endpoint

`GET https://api.velafi.com/v2/webhooks`

## Parámetros de consulta

**status** `integer`

Opcional. Filtra por estado del webhook. Si se omite, se devuelven los webhooks en todos los estados, incluidos los eliminados:

* `10` — activo
* `20` — deshabilitado
* `30` — eliminado

## Campos de la respuesta

**code** `number`

Código de respuesta de tipo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `array`

**campos de cada elemento de data**

**webhookId** `string`

Identificador único de este webhook.

**eventType** `string`

El tipo de evento que recibe este webhook (por ejemplo, `ORDER_WEBHOOK`).

**url** `string`

La URL de callback registrada.

**status** `number`

Estado del webhook: `10` = activo, `20` = deshabilitado, `30` = eliminado.

**publicKey** `string`

Clave pública RSA codificada en Base64 para verificar las firmas de los webhooks.

## Ejemplo

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/webhooks \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "status=10"
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": [
    {
      "webhookId": "ebab8a9663704e7cbbebe672c7c67912",
      "eventType": "ORDER_WEBHOOK",
      "url": "https://your-app.com/webhooks/velafi",
      "status": 10,
      "publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAp/6GRTIrl+kQb9u27cGz..."
    }
  ]
}
```

> [!TIP]
>
> Si necesitas rotar o reemplazar la URL de un webhook, obtén aquí el `webhookId` y luego llama al endpoint [Actualizar webhook](https://docs.velafi.com/es/api-reference/webhooks/update-a-webhook.md) con la nueva URL.


## Related topics

- [Crear un webhook](https://docs.velafi.com/es/api-reference/webhooks/create-webhook-endpoints.md)
- [Eliminar un webhook](https://docs.velafi.com/es/api-reference/webhooks/delete-a-webhook.md)
- [Configuración de webhooks](https://docs.velafi.com/es/api-reference/webhooks/webhook-setup.md)
- [Listar retiros cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/get-crypto-withdrawal-history.md)
- [Listar comercios](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchants.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.