List users

GET/users

Returns the users of the account, using cursor-based pagination.

The collection can be filtered by a search term matched against name and email (q), by external_id, and by tag (tag_id[], which matches users with any of the given tags). Users in the trash are excluded by default; set deleted=true to list only users in the trash.

The document and phone fields are returned only when the credentials have the users.read_personal permission.

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
q?string
external_id?string
deleted?boolean
tag_id[]?array<string>

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users"
{  "data": [    {      "access": "granted",      "created_at": "2019-08-24T14:15:22Z",      "deleted": true,      "document": "string",      "email": "[email protected]",      "external_id": "string",      "id": "string",      "name": "string",      "object": "user",      "phone": "string",      "revision": "string",      "status": "active",      "tags": [        "string"      ],      "updated_at": "2019-08-24T14:15:22Z"    }  ]}