Skip to content
by Unity Nodes
Partner docsapi reference › admin › list all organizations with pagination admin only

NEAR AI Cloud: List all organizations with pagination (Admin only)

Updated 13-11-2026

GET /v1/admin/organizations List all organizations with pagination (Admin only) Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

Returns a paginated list of all organizations in the system with their spend limits and usage. Only authenticated admins can perform this operation.

Admin permissions: admin session, read_write token, or read_only token. Approved read across organizations; does not mutate business state.

Parameters:

  • limit (query, integer): Maximum number of organizations to return (default: 100).
  • offset (query, integer): Number of organizations to skip (default: 0).
  • lifecycle (query, string): Filter by lifecycle: active (default), deleted, erased or all.

Responses: 200: Organizations retrieved successfully

  • limit (integer, int64, required)
  • offset (integer, int64, required)
  • organizations (array of object, required)
    • created_at (string, date-time, required)
    • currentUsage: one of option 1: null OrganizationUsage: object
    • description (string)
    • id (string, required)
    • lifecycle (string, required): Organization state derived from organizations.is_active and its membership rows. Serialized as active, deleted or erased (public API vocabulary). one of active, deleted, erased
    • name (string, required)
    • spendLimit: one of option 1: null SpendLimit: object
  • total (integer, int64, required) 401: Unauthorized 403: Missing admin privileges (forbidden) or insufficient token permission (insufficient_permissions). 500: Internal server error