---
title: "Get Users"
method: GET
path: "/v1/admin/users"
tags: ["beta.admin.users"]
---

# Get Users

`GET /v1/admin/users`

List Organization members and pending invitations.

## Query parameters

- `page` integer — Page number to return.
- `page_size` integer — Maximum number of results per page.
- `email` string, nullable — Email address to filter users and invitations.

## Response `200`

OK

- OrganizationAdminUsersOUT
  - `members` AdminOrganizationMemberOUT[], required — Organization members on this page.
    - `uuid` string, uuid, required — Organization member ID.
    - `oid_id` string, uuid, nullable, required — Identity provider ID for the member.
    - `name` string, nullable, required — Name of the Organization member.
    - `email` string, nullable, required — Email address of the Organization member.
    - `is_sso_outsider` boolean, nullable — Whether the member is outside the SSO domain.
    - `workspaces` MemberWorkspaceInfo[], nullable — Workspaces the member belongs to.
      - `uuid` string, uuid, required — Workspace ID.
      - `name` string, required — Workspace name.
      - `is_default` boolean, required — Whether this is the default Workspace for the Organization.
      - `raw_roles` union, required — Workspace roles assigned to the member.
        - WorkspaceRole[]
        - StaticWorkspaceRoles[]
      - `raw_role` union, required — Deprecated single workspace role. Use 'raw_roles' instead.
        - 'A' | 'M'
        - 'd7ea77c5-9260-41d0-ab26-52b5add3ee56' | '48436751-ee56-44bd-8a2d-712233977821' | '375cd0db-3bbe-4b79-80f3-954ccf04f3d1' | '578584f1-4319-4c88-9948-38a5184483b6' | 'd79b3027-4eb2-4521-8722-825acfee7d8b' | '252a0825-40b9-4b98-be80-7658956f13e9' | '17aa61c5-1c61-477e-a40a-e52c8ccd74b9' | 'b23cd6e0-91cd-4a8a-9869-b30366bf3966' | '731eb2be-a74f-4070-b797-35bf7009e553' | 'ff86d432-7f27-47f8-b02f-b5c102ef6a55' | '0f9acbf6-93b5-42c7-a227-fc7652755f65' | 'b23cd6e0-91cd-4a8a-9869-b30366bf3966'
    - `subscriptions` MemberSubscriptionOUT[] — Subscriptions assigned to the member.
      - `type` 'API' | 'CHAT' | 'ON_PREMISE' | 'LICENSE' | 'MISTRAL_CODE', required
      - `plan` union — Plan assigned to the member.
        - 'FREE' | 'PAY_AS_YOU_GO'
        - 'INDIVIDUAL' | 'EDU' | 'TEAM'
        - 'ENTERPRISE'
      - `status` 'NS' | 'S' | 'A' | 'CF' | 'CG' | 'C' | 'GP'
      - `user` string, nullable — User ID associated with the subscription.
      - `self_service` boolean, nullable — Whether the subscription was created through self-service.
      - `member_has_access` boolean, nullable — Whether the member currently has access to the plan.
    - `raw_roles` union, required — Organization roles assigned to the member.
      - UserRole[]
      - StaticOrganizationRoles[]
    - `raw_role` union, required — Deprecated single organization role. Use 'raw_roles' instead.
      - 'A' | 'M' | 'B'
      - '0d48f530-095c-43fe-8aea-6673bcacabe6' | 'c955f4e1-9477-43f0-8349-6fbc629fccc9' | '7bde5959-d676-47d2-b779-35b64323d278'
    - `subscription_types` string[], nullable — Product seats assigned to the member.
    - `created_at` string, date-time, required — Date the member was added to the Organization.
  - `invites` OrganizationInviteOUT[], required — Pending Organization invitations on this page.
    - `uuid` string, uuid, required — Organization invitation ID.
    - `raw_roles` union, required — Organization roles assigned by the invite.
      - UserRole[]
      - StaticOrganizationRoles[]
    - `raw_role` union, required — Deprecated single invite role. Use 'raw_roles' instead.
      - 'A' | 'M' | 'B'
      - '0d48f530-095c-43fe-8aea-6673bcacabe6' | 'c955f4e1-9477-43f0-8349-6fbc629fccc9' | '7bde5959-d676-47d2-b779-35b64323d278'
    - `email` string, required — Email address invited to the Organization.
    - `expired` boolean, required — Whether the invitation has expired.
    - `created_at` string, date-time, required — Time when the invitation was created.
    - `workspace_uuids` string[] — Workspace IDs the invited user will join.
  - `total` integer, nullable, required — Total number of users and invitations that match the request.
  - `page` integer, nullable, required — Page number returned.
  - `page_size` integer, nullable, required — Maximum number of results per page.

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)