Skip to main content
GET
/
workspaces
/
{workspaceId}
/
organizations
List organizations
curl --request GET \
  --url https://v1.api.altostrat.io/workspaces/{workspaceId}/organizations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "org_aBcDeFg123456789",
      "name": "Engineering Department",
      "workspace_id": "ws_a1b2c3d4e5f6g7h8",
      "external_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "parent_org_id": "org_zYxWvUt987654321",
      "path": "org_root123#org_parent456",
      "depth": 2,
      "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
      "picture": "https://cdn.altostrat.io/logos/engineering.png",
      "usage": {
        "usage": {
          "locations": 2,
          "users": 5
        },
        "subtree_usage": {
          "locations": 10,
          "users": 25
        }
      },
      "limits": {
        "locations": 10,
        "users": 50
      },
      "branding": {
        "display_name": "ACME Corp",
        "login_hint": "acme-corp",
        "colors": {
          "primary": "#FF5733",
          "page_background": "#FFFFFF"
        }
      }
    }
  ],
  "has_more": false
}

Documentation Index

Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Enter your JWT in the format: Bearer {token}

Path Parameters

​
workspaceId
string
required

The ID of the workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

Response

A list of organization objects.

​
data
object[]
​
has_more
boolean
Example:

false