List Organizations

GET /unified/iam/organizations

Authentication

Requires Authorization: Basic {base64_encoded_api_key} and x-account-id: {account_id}. See authentication.

Query Parameters

Parameter	Type	Required	Description
`fields`	string	No	Comma-separated list of fields to include in the response
`filter[updated_after]`	string (ISO 8601)	No	Only return organizations updated after this timestamp
`next`	string	No	Cursor token for the next page of results
`expand`	string	No	Comma-separated list of relations to expand
`raw`	boolean	No	Include the raw provider response alongside the unified data
`proxy`	object	No	Additional headers to pass through to the provider

Response

Returns a paginated list of IamOrganization objects.

Field	Type	Description
`id`	string	StackOne unique identifier
`remote_id`	string	Provider’s unique identifier
`name`	string	Organization name
`created_at`	string (ISO 8601)	When the organization was created
`updated_at`	string (ISO 8601)	When the organization was last updated

Example

cURL
TypeScript
Python

curl --request GET \
  --url 'https://api.stackone.com/unified/iam/organizations' \
  --header 'accept: application/json' \
  --header 'authorization: Basic {base64_encoded_api_key}' \
  --header 'x-account-id: {account_id}'

import { StackOne } from "@stackone/stackone-client-ts";

const client = new StackOne({ apiKey: "v1.eu1.xxxxx" });

const response = await client.iam.listOrganizations({
  xAccountId: "your-account-id",
});

console.log(response.organizations);

from stackone_client import StackOne

client = StackOne(api_key="v1.eu1.xxxxx")

response = client.iam.list_organizations(
    x_account_id="your-account-id"
)

print(response.organizations)

Example Response

{
  "data": [
    {
      "id": "org_01abc123",
      "remote_id": "T08G6Q9TP4L",
      "name": "Acme Corp",
      "created_at": "2023-01-01T00:00:00.000Z",
      "updated_at": "2024-06-15T10:30:00.000Z"
    }
  ],
  "next": "cursor_token_here"
}

Errors

Status	Meaning
400	Bad request — invalid query parameters
401	Unauthorized — invalid or missing API key
403	Forbidden — insufficient permissions
404	Not found — account not found
422	Provider does not support this endpoint

Getting Started

Users

Roles

Groups

Organizations

Me

Resource Types

Resource Users

List Organizations

Authentication

Query Parameters

Response

Example

Example Response

Errors

Getting Started

Users

Roles

Groups

Organizations

Me

Resource Types

Resource Users

​Authentication

​Query Parameters

​Response

​Example

​Example Response

​Errors

Authentication

Query Parameters

Response

Example

Example Response

Errors