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

# List Webhook Events

> Retrieve delivery history for a webhook partner

Returns a list of webhook events delivered (or attempted) to a specific partner, optionally filtered by delivery status.

## Path Parameters

<ParamField path="partnerId" type="string" required>
  ID of the webhook partner.
</ParamField>

## Query Parameters

<ParamField query="status" type="string">
  Filter by delivery status (e.g., `delivered`, `failed`, `pending`).
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Maximum number of events to return.
</ParamField>

## Response Fields

<ResponseField name="success" type="boolean">Request status.</ResponseField>

<ResponseField name="data" type="object[]">
  Array of webhook event records with delivery status and payload summary.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/stocks/api/webhooks/events/wh_abc123?status=failed&limit=10" \
    -H "X-API-Key: trusset_abc123xy_secret..."
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    `https://api.trusset.org/stocks/api/webhooks/events/${partnerId}?status=failed&limit=10`,
    {
      headers: { 'X-API-Key': 'trusset_abc123xy_secret...' }
    }
  );
  const { data } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": [
      {
        "eventId": "evt_xyz789",
        "type": "token.issued",
        "status": "delivered",
        "deliveredAt": "2025-06-15T12:01:00.000Z",
        "payload": {
          "tokenAddress": "0x1234...",
          "recipient": "0xAbC1...",
          "amount": "1000"
        }
      }
    ],
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-06-15T12:00:00.000Z",
      "instanceId": "inst_abc123"
    }
  }
  ```
</ResponseExample>