List Users
api/admin/users/list
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/admin/users/list Changed · +14 / -13 lines
# List Users ## Query parameters ## Returns ## Example ### Response (200) ## List Users ### Query Parameters ### Returns ### Example #### Response
---- -title: List Users -url: https://platform.claude.com/docs/en/api/admin/users/list ---- +# List Users -## List Users +**GET** `/v1/organizations/users` -**get** `/v1/organizations/users` - For Claude Enterprise organizations, this endpoint's availability is in beta. -### Query Parameters +## Query parameters - `after_id: optional string`
Filter by user email. + format: email + - `limit: optional number` Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`. + default: 20, maximum: 1000, minimum: 1 + - `roles: optional array of string` Filter to items whose `role` equals one of the supplied values. Repeatable; values are OR'ed together.
Accepted values depend on the organization type: Console and API organizations accept `user`, `developer`, `billing`, `admin`, and `claude_code_user`; Claude Enterprise organizations (beta) accept `user`, `owner`, `primary_owner`, `membership_admin`, and `managed`. -### Returns +## Returns - `data: array of User`
RFC 3339 datetime string indicating when the User joined the Organization. + format: date-time + - `email: string` Email of the User.
For Users, this is always `"user"`. - - `"user"` + default: user - `first_id: string or null`
Last ID in the `data` list. Can be used as the `after_id` for the next page. -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/organizations/users \ -H 'anthropic-version: 2023-06-01' \ -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN" ``` -#### Response +### Response (200) ```json {