---
title: "Retrieve members of a specific organization"
method: GET
path: "/manage/api/organization/members"
tags: ["manage"]
---

# Retrieve members of a specific organization

`GET /manage/api/organization/members`

Returns both active members and pending invites for the organization. A pending invite is identified by a non-null invite_status (e.g. PENDING); active members have a null invite_status.

## Query parameters

- `organization_id` string, required

## Response `200`

Organization members retrieved successfully

- GetOrganizationMembersResponse
  - `members` OrganizationMember[], required — List of organization members
    - `user_id` string, nullable — Base64 encoded user ID. Null for a pending invite to an email that has no account yet.
    - `display_handle` string, nullable — The display handle/username of the member. Null for a pending invite to an email that has no account yet.
    - `email_address` string, required — The email address of the member
    - `avatar_url` string, uri, nullable — URL to the member's avatar image. Null for a pending invite to an email that has no account yet.
    - `role` 'OWNER' | 'ADMIN' | 'MEMBER', required — Role within an organization profile. ADMIN only exists for TEAM_API organizations.
    - `full_name` string, nullable — User's full name if entered through user profile.
    - `invite_status` string, nullable — Invite status, e.g. PENDING. Only populated while the member is still a pending invite; null for active members.
    - `invite_id` string, nullable — Base64 encoded invite ID. Only populated while the member is still a pending invite; null for active members.
    - `invite_expiry_time` string, date-time, nullable — When the pending invite expires. Only populated while the member is still a pending invite; null for active members.

## Other responses

- `401` — Not authorized
- `403` — Not authorized
- `404` — Organization not found

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/bd40f367a834/schema)
