Skip to main content
GET
/
v2
/
users
List users
curl --request GET \
  --url https://api.arize.com/v2/users \
  --header 'Authorization: Bearer <token>'
{
  "users": [
    {
      "id": "VXNlcjoxMjM0NQ==",
      "name": "Jane Smith",
      "email": "jane.smith@example.com",
      "created_at": "2024-01-01T12:00:00Z",
      "status": "active",
      "role": {
        "type": "predefined",
        "name": "member"
      },
      "is_developer": true
    },
    {
      "id": "VXNlcjo2Nzg5MA==",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "created_at": "2024-01-02T12:00:00Z",
      "status": "invited",
      "role": {
        "type": "predefined",
        "name": "admin"
      },
      "is_developer": true
    }
  ],
  "pagination": {
    "next_cursor": "cursor_12345",
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Query Parameters

limit
integer
default:50

Maximum items to return

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

email
string

Filter users by email address (case-insensitive partial match, up to 255 characters). Results are scoped to users visible to the caller.

Maximum string length: 255
status
enum<string>[]

Filter users by account status. When omitted, active, invited, and expired users are returned. Can be specified multiple times to filter by multiple statuses (e.g., ?status=active&status=invited).

Current status of the user in the account.

  • active: User has verified their email and can access the platform.
  • invited: User has been invited and their verification token is still valid.
  • expired: User was invited but their verification token has expired or is missing. A new invite is required.
Available options:
active,
invited,
expired

Response

Returns a list of account user objects

users
object[]
required

A list of account users

pagination
object
required

Pagination metadata for cursor-based navigation