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

List applications

GET /v1/applications

Returns the applications of the Bitrix24 account that are visible to the key owner — their own, the ones colleagues shared, or everything together. The selection is paged, and a row carries the same field set as an application card.

Parameters

Parameter	Type	Req.	Default	Description
`scope` (query)	string	no	`feed`	Which applications to return: `mine` — your own, `shared` — other people's applications you can access, `feed` — both together. The values are case-sensitive, and an empty `scope=` answers `400 INVALID_SCOPE` just like an unknown one: either omit the parameter or send one of the three values
`page` (query)	number	no	`1`	Page number, counting from one. A value below one and a non-numeric value are both read as `1`
`limit` (query)	number	no	`50`	How many applications per page, at most `100`. A larger value is clamped to `100`; `0` and a non-numeric value fall back to `50`; a negative value becomes `1`

Paging is driven by total, page and limit from the response: request pages one after another until the number of rows collected reaches total. A page past the end of the selection answers 200 with an empty data array rather than an error.

Counting pages as total / limit is valid only when truncated is false. On true, total stops being a full count, there are no pages beyond it, and the remainder is reached through mine and shared, which have no ceiling.

Examples

curl — personal key

Terminal

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.com/v1/applications?scope=mine&limit=20"

curl — OAuth application

Terminal

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  "https://vibecode.bitrix24.com/v1/applications?scope=mine&limit=20"

JavaScript — personal key

javascript

const res = await fetch('https://vibecode.bitrix24.com/v1/applications?scope=mine&limit=20', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data: applications, total } = await res.json()

applications.forEach(app => {
  const state = app.activeOperation
    ? `${app.activeOperation.kind} — ${app.activeOperation.status}`
    : app.server?.status ?? 'no server'
  console.log(`${app.name}: ${state}`)
})
console.log(`Showing ${applications.length} of ${total}`)

JavaScript — OAuth application

javascript

const res = await fetch('https://vibecode.bitrix24.com/v1/applications?scope=mine&limit=20', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data: applications, total } = await res.json()

Response fields

Field	Type	Description
`success`	boolean	Always `true` on success
`data`	array	Array of applications. An array element and the `data` of a single card have the same shape, and the fields of that shape are described on the Application card page
`total`	number	How many applications matched the requested `scope`. On `feed` this is the size of the selection rather than the number of applications on the Bitrix24 account — read `truncated` before counting pages from it
`page`	number	The number of the page served, already clamped to an allowed value
`limit`	number	The page size, already clamped to an allowed value
`truncated`	boolean	Whether the output was cut short. Always present, in every `scope`. `false` — `total` is exact. `true` — `total` is the size of the selection, not how many exist, and there are no pages beyond it

Response example

JSON

{
  "success": true,
  "data": [
    {
      "id": "cmsw806qp0001tdskzf6mitka",
      "name": "Draft with no server",
      "description": null,
      "type": "PERSONAL",
      "iconUrl": null,
      "createdAt": "2026-08-16T19:51:18.817Z",
      "updatedAt": "2026-08-16T19:51:18.817Z",
      "viewerState": "owner",
      "pinned": false,
      "author": { "name": "Application author" },
      "isEmbedded": true,
      "openUrl": null,
      "openTarget": null,
      "server": null,
      "sources": { "hasVersions": false, "latestVersionId": null, "latestSavedAt": null },
      "activeOperation": null
    },
    {
      "id": "cmsw806qi0000tdskiw2aegii",
      "name": "Deal report",
      "description": "Pipeline summary for the period",
      "type": "PERSONAL",
      "iconUrl": null,
      "createdAt": "2026-08-16T19:51:18.810Z",
      "updatedAt": "2026-08-16T19:51:18.810Z",
      "viewerState": "owner",
      "pinned": false,
      "author": { "name": "Application author" },
      "isEmbedded": false,
      "openUrl": "https://app-05b67cf7.vibecode.bitrix24.com",
      "openTarget": "app",
      "server": {
        "id": "5cbb50f9-f95f-4ddf-ba3b-b771209cb6fb",
        "status": "RUNNING",
        "url": "https://app-05b67cf7.vibecode.bitrix24.com",
        "kind": "STANDALONE",
        "reachable": true,
        "lastDeployedAt": "2026-08-16T19:50:41.302Z"
      },
      "sources": {
        "hasVersions": true,
        "latestVersionId": "v2",
        "latestSavedAt": "2026-08-16T19:41:18.818Z"
      },
      "activeOperation": {
        "kind": "deploy",
        "status": "running",
        "step": "build",
        "startedAt": "2026-08-16T19:50:33.822Z"
      }
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 50,
  "truncated": false
}

Error response example

400 — the scope value is outside the allowed set: