List users

curl --request GET \
  --url https://staging.api.us.aptlydone.com/auth/v1/user \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://staging.api.us.aptlydone.com/auth/v1/user"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://staging.api.us.aptlydone.com/auth/v1/user', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging.api.us.aptlydone.com/auth/v1/user",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://staging.api.us.aptlydone.com/auth/v1/user"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://staging.api.us.aptlydone.com/auth/v1/user")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://staging.api.us.aptlydone.com/auth/v1/user")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "statusCode": 200,
  "timestamp": "2026-01-12T09:10:13.120Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "id": "d4b8eae5-02dc-4a9a-9afe-b2f72e006ebb",
        "userId": "10001",
        "loginId": "[email protected]",
        "descopeUserId": "7eOCsfn938mPjGwc5IZu4m5QAQWZS0xy",
        "activeTenantId": "3d4c3b64-f52d-4890-aa26-ea2e52eb5a4d",
        "email": "[email protected]",
        "name": "Vera Wolf",
        "displayName": "Brooke Rohan",
        "isSAML": false,
        "mobilePhone": "1-491-503-1712 x7659",
        "firstName": "Jolie",
        "lastName": "Morissette-Spencer",
        "profileImageUrl": "https://loremflickr.com/807/3278?lock=727001695474930",
        "currencyName": "Euro",
        "currencyCode": "EUR",
        "accountType": "h",
        "autoProvisioned": false,
        "employeeId": "f",
        "employeeNumber": "h",
        "employeeType": "D",
        "employmentType": "j",
        "userType": "z",
        "sourceId": "LaTdLstQ4lRlowebEqMq",
        "actorType": "khOhlolFNb",
        "aiAgentType": "XwUPLzjRvaLBsCG",
        "startDate": "2025-11-19T05:27:09.941Z",
        "terminationDate": "2026-10-16T18:32:34.796Z",
        "customAttributes": {
          "department": "Engineering",
          "level": "Senior"
        },
        "externalId": "EXT12345",
        "instanceId": "6a5dd288-ec68-44ff-a1ce-b0128347b3b6",
        "systemIntegrationId": "6e94c7f7-576d-48ed-8cc0-b8b09f56cba8",
        "displayLanguage": "en-US",
        "columnViewSettings": {
          "columns": [
            "name",
            "email",
            "status"
          ]
        },
        "searchData": [
          "Directives",
          "Liaison"
        ],
        "managerSync": true,
        "manager": {
          "id": "f99a50c1-f10a-47ee-a20d-8792e1a41be8",
          "userId": "10001",
          "descopeUserId": "NAe2gVjONZqYRgtvliF3pyKmPchGcHXg",
          "name": "Mr. Ivan Thiel",
          "email": "[email protected]",
          "firstName": "Adan",
          "lastName": "Johnston",
          "displayName": "Lucia Mayert",
          "mobilePhone": "(270) 663-0245 x3376",
          "profileImageUrl": "https://picsum.photos/seed/46GUUknbGJ/2329/2262",
          "createdOn": "2026-01-12T05:07:05.101Z",
          "updatedOn": "2026-01-12T03:30:03.871Z",
          "userPositions": [
            {
              "id": "64648e27-e093-44c3-b5a1-49154a0a1660",
              "userId": "898bf847-18c5-4022-b4be-6035aa06877f",
              "tenantId": "4f1cd86e-c077-4acc-b242-09478ad3ec79",
              "positionsId": "d2e8b360-686c-4e2c-a788-5ca9d7fc3daa",
              "autoProvisioned": true,
              "instanceId": "14120202-09d5-4b50-b522-b41d0821f7d0",
              "isEditable": false,
              "isDeleted": true,
              "deletedOn": "2025-08-19T23:46:35.207Z",
              "createdOn": "2026-01-11T12:03:07.517Z",
              "updatedOn": "2026-01-11T19:28:18.878Z",
              "positionName": "Senior Developer",
              "isSCIMProvisioned": false,
              "externalId": "f143825c-798e-43bb-8f88-da1ff0d8b399"
            }
          ],
          "primaryOrganization": {
            "groupName": "Aplty Inc.",
            "displayName": "Aplty Incorporated",
            "tenantGroupTypeId": "03cf8779-7be8-4ea9-a02e-99aa4454e94a",
            "tenantGroupTypeName": "Organization"
          },
          "managerName": "Doris Brakus",
          "managerProfileImageUrl": "https://loremflickr.com/567/2473?lock=5385426157985712"
        },
        "isDeleted": true,
        "isExpirePassword": true,
        "createdOn": "2026-01-12T04:59:38.064Z",
        "lastLoginDate": "2026-01-11T09:45:20.832Z",
        "createdBy": "56dbdb67-fdb4-478c-bb02-cea7b3e899ec",
        "updatedOn": "2026-01-11T11:57:54.376Z",
        "updatedBy": "f6267b64-ddad-4db5-ab64-b587d49af1b6",
        "deletedOn": "2025-01-27T10:51:41.196Z",
        "delegationsReceived": 1,
        "delegationsIssued": 1,
        "dashboardData": [
          {
            "x": 0,
            "y": 0,
            "w": 2,
            "h": 1,
            "i": "0"
          },
          {
            "x": 0,
            "y": 1,
            "w": 2,
            "h": 4,
            "i": "1"
          },
          {
            "x": 0,
            "y": 5,
            "w": 1,
            "h": 4,
            "i": "2"
          },
          {
            "x": 1,
            "y": 5,
            "w": 1,
            "h": 4,
            "i": "3"
          }
        ],
        "userRoles": [
          {
            "id": "320bf21d-7b31-4b31-93ef-1a2e9f93f8a9",
            "tenantId": "8fcca66f-5b95-4f54-a8fd-b1c27dd092ef",
            "tenantRoleId": "9c9bd186-23f1-4f5f-877f-b25aad685652",
            "roleName": "pine begonia",
            "autoProvisioned": false,
            "instanceId": "5863ab84-7099-4ac2-8b48-f24f1b21b4a3",
            "createdOn": "2026-01-11T22:33:40.204Z",
            "deletedOn": "2025-05-31T10:27:33.998Z",
            "updatedOn": "2026-01-12T03:25:36.185Z"
          }
        ],
        "userPositions": [
          {
            "id": "64648e27-e093-44c3-b5a1-49154a0a1660",
            "userId": "898bf847-18c5-4022-b4be-6035aa06877f",
            "tenantId": "4f1cd86e-c077-4acc-b242-09478ad3ec79",
            "positionsId": "d2e8b360-686c-4e2c-a788-5ca9d7fc3daa",
            "autoProvisioned": true,
            "instanceId": "14120202-09d5-4b50-b522-b41d0821f7d0",
            "isEditable": false,
            "isDeleted": true,
            "deletedOn": "2025-08-19T23:46:35.207Z",
            "createdOn": "2026-01-11T12:03:07.517Z",
            "updatedOn": "2026-01-11T19:28:18.878Z",
            "positionName": "Senior Developer",
            "isSCIMProvisioned": false,
            "externalId": "f143825c-798e-43bb-8f88-da1ff0d8b399"
          }
        ],
        "userGroups": [
          {
            "id": "77827dfa-cf21-4fec-a5bd-c568d9583431",
            "tenantId": "277ab493-cb1d-40f3-8d61-6432cc78df9a",
            "userId": "0e2a3c9d-3210-4e98-9dcc-67e8f63305c1",
            "groupId": "2b0e14b4-2d70-4517-afc3-9ba10bb890c2",
            "groupTypeId": "40471fbe-5866-486d-9f76-c96482e42277",
            "groupName": "Engineering Team",
            "groupTypeName": "Department",
            "displayName": "Engineering Department",
            "isPrimaryOrg": false,
            "externalId": "0802fdf7-09f2-4445-9e7c-3fc145cbf544",
            "instanceId": "c024da14-f39b-4aa5-9be8-6003132f6c71",
            "primaryOrgSetOn": "2026-01-11T23:45:02.944Z",
            "autoProvisioned": true,
            "isDeleted": true,
            "deletedOn": "2025-06-16T09:06:25.957Z",
            "createdOn": "2026-01-11T10:22:54.670Z",
            "updatedOn": "2026-01-11T18:31:52.005Z"
          }
        ],
        "status": "ACTIVE",
        "dateFormat": "MM/DD/YYYY",
        "isImpersonated": true
      }
    ]
  }
}

GET

user

List users

curl --request GET \
  --url https://staging.api.us.aptlydone.com/auth/v1/user \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://staging.api.us.aptlydone.com/auth/v1/user"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://staging.api.us.aptlydone.com/auth/v1/user', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging.api.us.aptlydone.com/auth/v1/user",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://staging.api.us.aptlydone.com/auth/v1/user"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://staging.api.us.aptlydone.com/auth/v1/user")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://staging.api.us.aptlydone.com/auth/v1/user")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "statusCode": 200,
  "timestamp": "2026-01-12T09:10:13.120Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "id": "d4b8eae5-02dc-4a9a-9afe-b2f72e006ebb",
        "userId": "10001",
        "loginId": "[email protected]",
        "descopeUserId": "7eOCsfn938mPjGwc5IZu4m5QAQWZS0xy",
        "activeTenantId": "3d4c3b64-f52d-4890-aa26-ea2e52eb5a4d",
        "email": "[email protected]",
        "name": "Vera Wolf",
        "displayName": "Brooke Rohan",
        "isSAML": false,
        "mobilePhone": "1-491-503-1712 x7659",
        "firstName": "Jolie",
        "lastName": "Morissette-Spencer",
        "profileImageUrl": "https://loremflickr.com/807/3278?lock=727001695474930",
        "currencyName": "Euro",
        "currencyCode": "EUR",
        "accountType": "h",
        "autoProvisioned": false,
        "employeeId": "f",
        "employeeNumber": "h",
        "employeeType": "D",
        "employmentType": "j",
        "userType": "z",
        "sourceId": "LaTdLstQ4lRlowebEqMq",
        "actorType": "khOhlolFNb",
        "aiAgentType": "XwUPLzjRvaLBsCG",
        "startDate": "2025-11-19T05:27:09.941Z",
        "terminationDate": "2026-10-16T18:32:34.796Z",
        "customAttributes": {
          "department": "Engineering",
          "level": "Senior"
        },
        "externalId": "EXT12345",
        "instanceId": "6a5dd288-ec68-44ff-a1ce-b0128347b3b6",
        "systemIntegrationId": "6e94c7f7-576d-48ed-8cc0-b8b09f56cba8",
        "displayLanguage": "en-US",
        "columnViewSettings": {
          "columns": [
            "name",
            "email",
            "status"
          ]
        },
        "searchData": [
          "Directives",
          "Liaison"
        ],
        "managerSync": true,
        "manager": {
          "id": "f99a50c1-f10a-47ee-a20d-8792e1a41be8",
          "userId": "10001",
          "descopeUserId": "NAe2gVjONZqYRgtvliF3pyKmPchGcHXg",
          "name": "Mr. Ivan Thiel",
          "email": "[email protected]",
          "firstName": "Adan",
          "lastName": "Johnston",
          "displayName": "Lucia Mayert",
          "mobilePhone": "(270) 663-0245 x3376",
          "profileImageUrl": "https://picsum.photos/seed/46GUUknbGJ/2329/2262",
          "createdOn": "2026-01-12T05:07:05.101Z",
          "updatedOn": "2026-01-12T03:30:03.871Z",
          "userPositions": [
            {
              "id": "64648e27-e093-44c3-b5a1-49154a0a1660",
              "userId": "898bf847-18c5-4022-b4be-6035aa06877f",
              "tenantId": "4f1cd86e-c077-4acc-b242-09478ad3ec79",
              "positionsId": "d2e8b360-686c-4e2c-a788-5ca9d7fc3daa",
              "autoProvisioned": true,
              "instanceId": "14120202-09d5-4b50-b522-b41d0821f7d0",
              "isEditable": false,
              "isDeleted": true,
              "deletedOn": "2025-08-19T23:46:35.207Z",
              "createdOn": "2026-01-11T12:03:07.517Z",
              "updatedOn": "2026-01-11T19:28:18.878Z",
              "positionName": "Senior Developer",
              "isSCIMProvisioned": false,
              "externalId": "f143825c-798e-43bb-8f88-da1ff0d8b399"
            }
          ],
          "primaryOrganization": {
            "groupName": "Aplty Inc.",
            "displayName": "Aplty Incorporated",
            "tenantGroupTypeId": "03cf8779-7be8-4ea9-a02e-99aa4454e94a",
            "tenantGroupTypeName": "Organization"
          },
          "managerName": "Doris Brakus",
          "managerProfileImageUrl": "https://loremflickr.com/567/2473?lock=5385426157985712"
        },
        "isDeleted": true,
        "isExpirePassword": true,
        "createdOn": "2026-01-12T04:59:38.064Z",
        "lastLoginDate": "2026-01-11T09:45:20.832Z",
        "createdBy": "56dbdb67-fdb4-478c-bb02-cea7b3e899ec",
        "updatedOn": "2026-01-11T11:57:54.376Z",
        "updatedBy": "f6267b64-ddad-4db5-ab64-b587d49af1b6",
        "deletedOn": "2025-01-27T10:51:41.196Z",
        "delegationsReceived": 1,
        "delegationsIssued": 1,
        "dashboardData": [
          {
            "x": 0,
            "y": 0,
            "w": 2,
            "h": 1,
            "i": "0"
          },
          {
            "x": 0,
            "y": 1,
            "w": 2,
            "h": 4,
            "i": "1"
          },
          {
            "x": 0,
            "y": 5,
            "w": 1,
            "h": 4,
            "i": "2"
          },
          {
            "x": 1,
            "y": 5,
            "w": 1,
            "h": 4,
            "i": "3"
          }
        ],
        "userRoles": [
          {
            "id": "320bf21d-7b31-4b31-93ef-1a2e9f93f8a9",
            "tenantId": "8fcca66f-5b95-4f54-a8fd-b1c27dd092ef",
            "tenantRoleId": "9c9bd186-23f1-4f5f-877f-b25aad685652",
            "roleName": "pine begonia",
            "autoProvisioned": false,
            "instanceId": "5863ab84-7099-4ac2-8b48-f24f1b21b4a3",
            "createdOn": "2026-01-11T22:33:40.204Z",
            "deletedOn": "2025-05-31T10:27:33.998Z",
            "updatedOn": "2026-01-12T03:25:36.185Z"
          }
        ],
        "userPositions": [
          {
            "id": "64648e27-e093-44c3-b5a1-49154a0a1660",
            "userId": "898bf847-18c5-4022-b4be-6035aa06877f",
            "tenantId": "4f1cd86e-c077-4acc-b242-09478ad3ec79",
            "positionsId": "d2e8b360-686c-4e2c-a788-5ca9d7fc3daa",
            "autoProvisioned": true,
            "instanceId": "14120202-09d5-4b50-b522-b41d0821f7d0",
            "isEditable": false,
            "isDeleted": true,
            "deletedOn": "2025-08-19T23:46:35.207Z",
            "createdOn": "2026-01-11T12:03:07.517Z",
            "updatedOn": "2026-01-11T19:28:18.878Z",
            "positionName": "Senior Developer",
            "isSCIMProvisioned": false,
            "externalId": "f143825c-798e-43bb-8f88-da1ff0d8b399"
          }
        ],
        "userGroups": [
          {
            "id": "77827dfa-cf21-4fec-a5bd-c568d9583431",
            "tenantId": "277ab493-cb1d-40f3-8d61-6432cc78df9a",
            "userId": "0e2a3c9d-3210-4e98-9dcc-67e8f63305c1",
            "groupId": "2b0e14b4-2d70-4517-afc3-9ba10bb890c2",
            "groupTypeId": "40471fbe-5866-486d-9f76-c96482e42277",
            "groupName": "Engineering Team",
            "groupTypeName": "Department",
            "displayName": "Engineering Department",
            "isPrimaryOrg": false,
            "externalId": "0802fdf7-09f2-4445-9e7c-3fc145cbf544",
            "instanceId": "c024da14-f39b-4aa5-9be8-6003132f6c71",
            "primaryOrgSetOn": "2026-01-11T23:45:02.944Z",
            "autoProvisioned": true,
            "isDeleted": true,
            "deletedOn": "2025-06-16T09:06:25.957Z",
            "createdOn": "2026-01-11T10:22:54.670Z",
            "updatedOn": "2026-01-11T18:31:52.005Z"
          }
        ],
        "status": "ACTIVE",
        "dateFormat": "MM/DD/YYYY",
        "isImpersonated": true
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page

number

Page number

Required range: x >= 1

Example:

1

limit

number

Number of items per page

Required range: 1 <= x <= 100

Example:

10

tenantId

string<uuid>

required

Tenant ID

Example:

"b360ec79-ee0e-45a1-a6cc-279f5a10ab68"

string

Search term

status

string

Comma-separated list of user statuses to filter by

Example:

"ACTIVE,INACTIVE,INVITED"

sourceType

string

Comma-separated list of source types to filter by (e.g., "Directory Sync", "Manually Added")

Example:

"Directory Sync,Manually Added"

employeeType

string

Employee type filter

roleIds

string

Filter by role IDs (comma-separated UUIDs)

Example:

"f8e2d583-819a-463c-b815-af1c927b4017,6f5fbaec-a2a6-422b-93f3-b5d5532cdb88"

groupIds

string

Filter by group IDs (comma-separated UUIDs)

Example:

"2b63dc7d-4d1f-4f04-9611-23edb3e7ebfd,06c279f8-e3f6-4496-874a-f7f5aebad2c2"

positionIds

string

Filter by position IDs (comma-separated UUIDs)

Example:

"ce066ed3-1f02-4c6b-a1c4-d06986567e78,8674cce9-8fbf-409f-90fb-2e203803c35e"

managerIds

string

Filter by manager IDs (comma-separated UUIDs)

Example:

"379bb5dd-99f8-4afc-97f0-54368bc6f91c,7f1954e9-ee53-4ebf-be1e-00f2cd4520be"

primaryOrgIds

string

Filter by primary organization IDs (comma-separated UUIDs)

Example:

"8e6f65f2-bb0a-4762-bf1e-845f05cfc237,62cdb51a-b375-4ec8-ae8a-793c96316900"

externalId

string

Filter by external ID

Example:

"EXT123456"

createdDateStart

string<date-time>

Creation date range - start date

createdDateEnd

string<date-time>

Creation date range - end date

updatedDateStart

string<date-time>

Last updated date range - start date

updatedDateEnd

string<date-time>

Last updated date range - end date

Last login date range - start date

Last login date range - end date

sortBy

string

Field to sort by

sortOrder

enum<string>

Sort order

Available options:

asc,

desc

Response

200 - application/json

Users fetched successfully

statusCode

number

required

Example:

200

timestamp

string

required

Example:

"2026-01-12T09:10:13.120Z"

message

string

required

Example:

"Success"

data

object

Show child attributes

Get SSO settings Create user

⌘I

API Authentication

Decisions

Delegations

Matrices

Actions

Documents

Tenants

Users

Groups

Positions

Reporting

Notifications

List users

Authorizations

Query Parameters

Response