List Webhooks

Returns all webhook endpoints registered for the authenticated workspace.

GET /v1/webhooks

webhooks:read

Request Examples

curl

curl -X GET https://xqr.co/api/v1/webhooks \
  -H "Authorization: Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

TypeScript

const response = await fetch("https://xqr.co/api/v1/webhooks", {
  headers: {
    Authorization: "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  },
});

const { data } = await response.json();
console.log(`${data.length} webhooks registered`);

Python

import httpx

response = httpx.get(
    "https://xqr.co/api/v1/webhooks",
    headers={
        "Authorization": "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
)

data = response.json()["data"]
print(f"{len(data)} webhooks registered")

Response

200 OK

An array of webhook objects.

{
  "data": [
    {
      "id": "wh_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "url": "https://example.com/webhooks/xqr",
      "events": ["link.created", "link.scanned"],
      "description": "Production link events",
      "enabled": true,
      "failure_count": 0,
      "created_at": "2026-03-21T14:30:00Z",
      "updated_at": "2026-03-21T14:30:00Z"
    },
    {
      "id": "wh_f7e8d9c0-b1a2-3456-7890-abcdef123456",
      "url": "https://example.com/webhooks/xqr-assets",
      "events": ["asset.uploaded"],
      "description": "Asset upload notifications",
      "enabled": true,
      "failure_count": 2,
      "created_at": "2026-03-10T08:00:00Z",
      "updated_at": "2026-03-20T12:15:00Z"
    }
  ],
  "meta": {
    "request_id": "req_9c0d1e2f3a4b5c67",
    "rate_limit": {
      "limit": 600,
      "remaining": 598,
      "reset": 1742572800
    }
  }
}