List

Get Users

get

Get a paginated list of users with filtering and sorting options.

Parameters: role: Optional[str] Filter users by role. Can be one of: - proxy_admin - proxy_admin_viewer - internal_user - internal_user_viewer user_ids: Optional[str] Get list of users by user_ids. Comma separated list of user_ids. sso_ids: Optional[str] Get list of users by sso_ids. Comma separated list of sso_ids. user_email: Optional[str] Filter users by partial email match team: Optional[str] Filter users by team id. Will match if user has this team in their teams array. page: int The page number to return page_size: int The number of items per page sort_by: Optional[str] Column to sort by (e.g. 'user_id', 'user_email', 'created_at', 'spend') sort_order: Optional[str] Sort order ('asc' or 'desc')

Authorizations

APIKeyHeader

Query parameters

roleany ofOptional

Filter users by role

stringOptional

or

nullOptional

user_idsany ofOptional

Get list of users by user_ids

stringOptional

or

nullOptional

sso_user_idsany ofOptional

Get list of users by sso_user_id

stringOptional

or

nullOptional

user_emailany ofOptional

Filter users by partial email match

stringOptional

or

nullOptional

teamany ofOptional

Filter users by team id

stringOptional

or

nullOptional

pageinteger · min: 1Optional

Page number

Default: 1

page_sizeinteger · min: 1 · max: 100Optional

Number of items per page

Default: 25

sort_byany ofOptional

Column to sort by (e.g. 'user_id', 'user_email', 'created_at', 'spend')

stringOptional

or

nullOptional

sort_orderstringOptional

Sort order ('asc' or 'desc')

Default: asc

Responses

get

HTTPcURLJavaScriptPython

GET /user/list HTTP/1.1
Host: 
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

{
  "users": [
    {
      "user_id": "text",
      "max_budget": 1,
      "spend": 1,
      "model_max_budget": {},
      "model_spend": {},
      "user_email": "text",
      "user_alias": "text",
      "models": [],
      "tpm_limit": 1,
      "rpm_limit": 1,
      "user_role": "text",
      "organization_memberships": [
        {
          "user_id": "text",
          "organization_id": "text",
          "user_role": "text",
          "spend": 1,
          "budget_id": "text",
          "created_at": "2025-04-25T10:15:19.901Z",
          "updated_at": "2025-04-25T10:15:19.901Z",
          "user": null,
          "litellm_budget_table": {
            "soft_budget": 1,
            "max_budget": 1,
            "max_parallel_requests": 1,
            "tpm_limit": 1,
            "rpm_limit": 1,
            "model_max_budget": {},
            "budget_duration": "text"
          }
        }
      ],
      "teams": [
        "text"
      ],
      "sso_user_id": "text",
      "budget_duration": "text",
      "budget_reset_at": "2025-04-25T10:15:19.901Z",
      "metadata": {},
      "created_at": "2025-04-25T10:15:19.901Z",
      "updated_at": "2025-04-25T10:15:19.901Z",
      "key_count": 1
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 1,
  "total_pages": 1
}