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 in the Bitrix24 account that the key owner can see — their own, those shared by colleagues, or both. Results are paginated, and each item has the same fields as an application card.

Parameters

Parameter	Type	Required	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. Values are case-sensitive. An empty `scope=` returns `400 INVALID_SCOPE`, as does an unknown value; either omit the parameter or set it to one of the three values
`page` (query)	number	no	`1`	Page number, starting from `1`. Values below `1` and non-numeric values are treated 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`

To paginate, use total, page and limit from the response: request pages sequentially until the number of rows collected reaches total. A page beyond the end of the result set returns 200 with an empty data array rather than an error.

Calculate the page count from total / limit only when truncated is false. When it is true, total is not a complete count and there are no further feed pages; retrieve the remaining applications through mine and shared, which are uncapped.

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. Each array item has the same shape as the `data` object returned for a single application; its fields are described on the Application card page
`total`	number	How many applications matched the requested `scope`. On `feed`, this is the size of the result set rather than the number of applications in the Bitrix24 account — read `truncated` before using it to calculate the page count
`page`	number	Returned page number, already normalized to an allowed value
`limit`	number	Returned page size, already normalized to an allowed value
`truncated`	boolean	Whether the result set was truncated. This field is always present for every `scope`. If `false`, `total` is exact. If `true`, `total` is the size of the result set rather than the complete count, 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: