curl -X GET 'https://api.openai.com/v1/organization/groups/group-id/users?limit=100&after=example-after&order=desc' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

# GET /organization/groups/{group_id}/users (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI admin key; required.
Last verified: 2026-10-20

> List group users

## Critical Gotchas
* The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
* Audio transcription uploads use multipart form data rather than a JSON request body.

## cURL
curl -X GET 'https://api.openai.com/v1/organization/groups/group-id/users?limit=100&after=example-after&order=desc' \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| group_id | path | string | Yes | The ID of the group to inspect. |
| limit | query | integer | No | A limit on the number of users to be returned. Limit can range between 0 and... |
| after | query | string | No | A cursor for use in pagination. Provide the ID of the last user from the prev... |
| order | query | string | No | Specifies the sort order of users in the list. |

## Response example
{"object":"list","data":[{}]}

---
Need an API key? Get one at https://platform.openai.com/api-keys

GET

GET /organization/groups/{group_id}/users — OpenAI API

OpenAI admin key (required); https://api.openai.com/v1

OpenAI API

List group users

Base URL: https://api.openai.com/v1
Auth: Authorization: Bearer <OPENAI_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 254 tokens · Vary: Accept

Critical gotchas

The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.

Audio transcription uploads use multipart form data rather than a JSON request body.

cURL

curl -X GET 'https://api.openai.com/v1/organization/groups/group-id/users?limit=100&after=example-after&order=desc' \  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

Parameters

Name	In	Type	Required	Description
group_id	path	string	Yes	The ID of the group to inspect.
limit	query	integer	No	A limit on the number of users to be returned. Limit can range between 0 and 1000, and the default is 100.
after	query	string	No	A cursor for use in pagination. Provide the ID of the last user from the previous list response to retrieve the next page.
order	query	string	No	Specifies the sort order of users in the list.

Response 200 OK

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "email": "string"
    }
  ],
  "has_more": true,
  "next": "string"
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.