Webhooks

List webhooks

get/client/webhooks

Return all webhooks for your organization.

Authorization

Bearer token in the Authorization header.

Query parameters

statusstring

Options: activeinactivefailed

eventstring

Options: verification.completedverification.failed

pageinteger

limitinteger

Request

curl -X GET 'https://api.lira.com/api/v1/client/webhooks' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const response = await fetch('https://api.lira.com/api/v1/client/webhooks', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.lira.com/api/v1/client/webhooks",
    headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
)

data = response.json()

Response

[
  {
    "id": "b8c9d0e1-f2a3-4567-bcde-890123456789",
    "organizationId": "d4e5f6a7-b8c9-0123-defa-456789012345",
    "url": "https://yourapp.com/webhooks/lira",
    "events": [
      "verification.completed",
      "verification.failed"
    ],
    "status": "active",
    "createdAt": "2026-04-22T10:15:30.000Z",
    "updatedAt": "2026-04-22T10:15:30.000Z"
  }
]