List installed apps · Ownrecord docs

Lists the apps installed in the organization, newest first: the app and its publisher (verified or not), who installed it, the scopes granted, limitTo and the status. Filter by status; paginate with limit and starting_after.

At a glance

REST: GET /api/v1/app_installations
MCP tool: app_installations_list
Operation ID: app_installations.list
Scope: Organization
Permission: agents:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Pagination: limit (at most 100) and starting_after
Authentication: API key with the agents:read scope
Since: M10

Request

Query parameters

Field	Type	Required
`limit`	integer (1 to 100)	No
`starting_after`	`ains_…` ID	No
`status`	one of `active`, `paused`, `revoked`	No

Response

200 OK with a JSON object, a page of the list (newest first):

Field	Type	Description
`object`	`"list"`
`data`	array of object
`data[].id`	`ains_…` ID
`data[].object`	`"app_installation"`
`data[].orgId`	`org_…` ID
`data[].app`	object
`data[].app.id`	`ocl_…` ID
`data[].app.name`	string
`data[].app.publisher`	string
`data[].app.logoUrl`	string or null
`data[].app.verified`	boolean
`data[].app.status`	one of `active`, `disabled`
`data[].app.suspension`	object or null
`data[].installedBy`	`usr_…` ID
`data[].scopes`	array of one of 84 values, e.g. `org:read`, `org:write`, `org:admin` (all in the OpenAPI document)
`data[].limitTo`	object
`data[].limitTo.entityIds`	array of `ent_…` ID
`data[].limitTo.brandIds`	array of `brd_…` ID
`data[].limits`	object
`data[].limits.rps`	integer or null
`data[].limits.mutationsPerDay`	integer or null
`data[].limits.amountLimits`	array of object
`data[].limits.amountLimits[].operationId`	string
`data[].limits.amountLimits[].perCall`	money or null
`data[].limits.amountLimits[].perDay`	money or null
`data[].status`	one of `active`, `paused`, `revoked`
`data[].pausedReason`	one of `manual`, `installer_lost_access`, `platform_suspended`, `app_disabled` or null
`data[].pausedAt`	string or null
`data[].revokedAt`	string or null
`data[].createdAt`	string
`data[].updatedAt`	string
`has_more`	boolean
`next_cursor`	`ains_…` ID or null

Examples

Installed apps

HTTP

GET /api/v1/app_installations
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "list",
  "data": [
    {
      "id": "ains_01m4ttwd3veh9apbewxheq5xhc",
      "object": "app_installation",
      "orgId": "org_01m4ttwd3veh9apbewxheq5xh3",
      "app": {
        "id": "ocl_01m4ttwd3veh9apbewxheq5xha",
        "name": "Ledgerly AI",
        "publisher": "Ledgerly AI B.V.",
        "logoUrl": null,
        "verified": true,
        "status": "active",
        "suspension": null
      },
      "installedBy": "usr_01m4ttwd3veh9apbewxheq5xh6",
      "scopes": ["filings:read", "filings:write", "tasks:read", "tasks:write"],
      "limitTo": {
        "entityIds": ["ent_01m4ttwd3veh9apbewxheq5xh4"],
        "brandIds": []
      },
      "limits": {
        "rps": null,
        "mutationsPerDay": null,
        "amountLimits": []
      },
      "status": "active",
      "pausedReason": null,
      "pausedAt": null,
      "revokedAt": null,
      "createdAt": "2026-10-25T09:00:00.000Z",
      "updatedAt": "2026-10-25T09:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Paused installations, one per page

HTTP

GET /api/v1/app_installations?status=paused&limit=1
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "list",
  "data": [
    {
      "id": "ains_01m4ttwd3veh9apbewxheq5xhc",
      "object": "app_installation",
      "orgId": "org_01m4ttwd3veh9apbewxheq5xh3",
      "app": {
        "id": "ocl_01m4ttwd3veh9apbewxheq5xha",
        "name": "Ledgerly AI",
        "publisher": "Ledgerly AI B.V.",
        "logoUrl": null,
        "verified": true,
        "status": "active",
        "suspension": null
      },
      "installedBy": "usr_01m4ttwd3veh9apbewxheq5xh6",
      "scopes": ["filings:read", "filings:write", "tasks:read", "tasks:write"],
      "limitTo": {
        "entityIds": ["ent_01m4ttwd3veh9apbewxheq5xh4"],
        "brandIds": []
      },
      "limits": {
        "rps": null,
        "mutationsPerDay": null,
        "amountLimits": []
      },
      "status": "paused",
      "pausedReason": "installer_lost_access",
      "pausedAt": "2026-10-26T14:30:00.000Z",
      "revokedAt": null,
      "createdAt": "2026-10-25T09:00:00.000Z",
      "updatedAt": "2026-10-26T14:30:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "ains_01m4ttwd3veh9apbewxheq5xhc"
}

Errors

Code	HTTP status	When	What to do
`validation_failed`	400	A filter or pagination value is invalid.	Fix the fields listed in `details.issues` and send the request again.
`permission_denied`	403	You can't see the organization's agents and apps.	Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: api_version_unsupported, authentication_required, api_key_invalid, resource_not_found, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Query parameters#

Response#

Examples#

Installed apps#

Paused installations, one per page#

Errors#