Get Organization

GET /unified/iam/organizations/{id}

Authentication

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

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The StackOne ID of the organization

Query Parameters

Parameter	Type	Required	Description
`fields`	string	No	Comma-separated list of fields to include
`raw`	boolean	No	Include the raw provider response

Response

Returns a single IamOrganization object.

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/org_01abc123' \
  --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.getOrganization({
  xAccountId: "your-account-id",
  id: "org_01abc123",
});

console.log(response.organization);

from stackone_client import StackOne

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

response = client.iam.get_organization(
    x_account_id="your-account-id",
    id="org_01abc123"
)

print(response.organization)

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"
  }
}

Errors

Status	Meaning
401	Unauthorized — invalid or missing API key
404	Organization not found
422	Provider does not support this endpoint

Getting Started

Users

Roles

Groups

Organizations

Me

Resource Types

Resource Users

Authentication

Path Parameters

Query Parameters

Response

Example

Example Response

Errors

Getting Started

Users

Roles

Groups

Organizations

Me

Resource Types

Resource Users

​Authentication

​Path Parameters

​Query Parameters

​Response

​Example

​Example Response

​Errors

Authentication

Path Parameters

Query Parameters

Response

Example

Example Response

Errors