v1

latestOpenAPI 3.0.02026-07-24212113249.1 KB
Accounts

List accounts

get/accounts

Query parameters

pageSizenumber

The number of documents that will be returned per page

pagenumber

Page to search. Page numbering starts with 0.

sortBystring

The sort-by field name and order. Format: <field_name>.<asc|desc> (asc for ascending and desc for descending order). If no order is specified, descending order is used.

tenant_idstring

Tenant ID

email__exactstring

Filter by email address.

username__exactstring

Filter by user name.

username__containsstring

Return only accounts where the user name contains this string.

first_name__exactstring

Filter by owner's first name.

first_name__containsstring

Return only accounts where the owner's first name contains this string.

last_name__exactstring

Filter by owner's last name.

last_name__containsstring

Return only accounts where the owner's last name contains this string.

is_adminboolean

Return only admin accounts.

activeboolean nullable

If True, return only active accounts.

block_tempstring date-time nullable

Return only accounts temporarily blocked until this date.

block_permboolean nullable

Return only permanently blocked accounts.

pending_activationboolean nullable

If True, return only accounts that are pending activation.

gdprboolean nullable

Return only accounts that have a GDPR requirement.

termstring

Filter by this term.

Headers

organizationstring required

The URL of the end-user web application

Response

Successful resopnse

pageinteger

The current page

pageSizeinteger

The number of objects per page

totalinteger

The total number of objects in the response

pageCountinteger

The total number of pages

pageNumberIsGoodboolean

Page number is valid.

hasPreviousPageboolean

There is a previous page.

hasNextPageboolean

There is a next page.

isFirstPageboolean

This is the first page.

isLastPageboolean

This is the last page.

Example response

{
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "pageCount": 1,
  "pageNumberIsGood": true,
  "isFirstPage": true,
  "isLastPage": true,
  "rows": [
    {
      "id": "646f8e4619b10e18eb768ea5",
      "display_name": "John Smith",
      "username": "John Smith",
      "first_name": "John",
      "last_name": "Smith",
      "email": "johnsmith@server.com",
      "status": {
        "active": true
      },
      "organization": "864soq9a3efc39a89a96d4sz",
      "is_admin": true
    }
  ]
}