Users

List the pages the account administers

Returns the company pages the connected account administers, each with its per-page capability matrix (post, sponsor, analytics, admin management) and the can_invite_to_follow gate. An account that administers no pages returns an empty list; a valid result, not an error.

get/v1/{account_id}/companies/managed

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/companies/managed
  • Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account whose administered pages to list.

Query parameters

limitinteger

Number of managed pages to return per page (1-100, default 10).

cursorstring

Opaque pagination cursor from a previous response. Omit for the first page.

Response

The company pages the account administers, each with its per-page admin capability matrix. An account that administers no pages returns an empty list; never a 403. Page names are returned verbatim and are stored in your tenant's entity records, with no expiry.

object'managed_company_list' required

Response type discriminator.

cursorstring nullable required

Always null for this resource; the full administered set returns in one page.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.