UPupguard
userrisk

List app users

Changed on

Retrieve a list of users using a specific application.

Required API key permissions: UserRisk (select when creating API key in Account Settings)

get/user_risk/apps/users/list

Request

Query parameters

page_sizeinteger

The page size of results to return. If not supplied, default is 100.

page_tokenstring

The page_token from a previous request, use this to get the next page of results.

sort_by'id' | 'email' | 'name' | 'risk_rating'

The field to sort results by. Default is id.

sort_dir'asc' | 'desc'

The direction to sort results. Default is asc.

app_namestring required

The name of the application.

Response

The list of users using the application

next_page_tokenstring

The token to be used to retrieve the next page of results. Will not be returned if there are no more results.

Example response

{
  "next_page_token": "e7cfc445-30a6-416c-8a12-0a988f042d08",
  "users": [
    {
      "email": "john.doe@example.com",
      "exposure_level": "basic",
      "first_detected": "2023-09-24T15:30:00Z",
      "id": "e7cfc445-30a6-416c-8a12-0a988f042d08",
      "name": "John Doe",
      "risk_rating": 750,
      "role": "developer",
      "team": "product",
      "usage_policy_outcome": "tolerate"
    }
  ]
}

Changes

  • d044bf6dc61eRevision changes
    • info

      added the new optional query request parameter sort_by

    • info

      added the new optional query request parameter sort_dir