For AI agents: markdown of this page — /docs-content-en/infra/event-subscriptions/list.md documentation index — /llms.txt

List subscriptions

GET /v1/infra/servers/:id/event-subscriptions

Returns the server's subscriptions and up to 50 recent deliveries. The recentDeliveries array is a log of the latest events with the status of each delivery and the error text if a delivery failed. Use it to check whether events are reaching the application.

Parameters

Parameter	In	Type	Req.	Description
`id`	path	string (UUID)	yes	Server ID. List: `GET /v1/infra/servers`

Examples

curl — personal key

Terminal

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.com/v1/infra/servers/SERVER_ID/event-subscriptions

curl — OAuth application

Terminal

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.com/v1/infra/servers/SERVER_ID/event-subscriptions

JavaScript — personal key

javascript

const res = await fetch(
  `https://vibecode.bitrix24.com/v1/infra/servers/${serverId}/event-subscriptions`,
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { success, data, recentDeliveries } = await res.json()
console.log(`Subscriptions: ${data.length}, deliveries in log: ${recentDeliveries.length}`)

JavaScript — OAuth application

javascript

const res = await fetch(
  `https://vibecode.bitrix24.com/v1/infra/servers/${serverId}/event-subscriptions`,
  {
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
const { success, data, recentDeliveries } = await res.json()

Response fields

Field	Type	Description
`success`	boolean	`true` on success
`data`	array	Array of subscriptions, newest first. Fields of each subscription — see Create subscription
`recentDeliveries`	array	Up to 50 recent deliveries, newest first. Older deliveries are not included in the response
`recentDeliveries[].id`	string (UUID)	Delivery ID
`recentDeliveries[].event`	string	Event code
`recentDeliveries[].status`	string	Delivery status: `PENDING`, `DELIVERING`, `DELIVERED`, `FAILED`
`recentDeliveries[].attempts`	number	Number of delivery attempts
`recentDeliveries[].lastError`	string \| null	Text of the last delivery error
`recentDeliveries[].createdAt`	string	When the event arrived (ISO 8601)
`recentDeliveries[].deliveredAt`	string \| null	When it was delivered to the application (ISO 8601), `null` if not yet delivered

Response example

JSON

{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "appId": "9a1c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "serverId": "e765edfc-ba0a-43de-b8ea-838dd872c522",
      "portalId": "8b1f0e2a-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
      "event": "ONTASKADD",
      "appPath": "/api/webhooks/b24",
      "authType": "1",
      "b24Handler": "https://vibecode.bitrix24.com/v1/portal-events/9a1c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "status": "ACTIVE",
      "createdById": "7f3a1c2b-9d8e-4a6f-b1c2-3d4e5f6a7b8c",
      "createdAt": "2026-06-07T10:00:00.000Z",
      "updatedAt": "2026-06-07T10:00:00.000Z"
    }
  ],
  "recentDeliveries": [
    {
      "id": "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "event": "ONTASKADD",
      "status": "DELIVERED",
      "attempts": 0,
      "lastError": null,
      "createdAt": "2026-06-07T10:05:00.000Z",
      "deliveredAt": "2026-06-07T10:05:01.000Z"
    }
  ]
}

Error response example

404 — server not found: