Get positions with users

Retrieves a paginated list of positions with their assigned users

GET /v1/user/personnel/positions

Get positions with users

cURL

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

200

{
  "statusCode": 200,
  "timestamp": "2026-01-12T09:10:13.123Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "positionId": "aeaed9a0-890d-4de2-8005-77c4ebba3833",
        "position": "Chief Brand Executive",
        "users": "Katherine Metz I, Dr. Darren Rogahn, Lewis Ferry"
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

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

Query Parameters

page · number · default: 1 · required

Page number

limit · number · default: 10 · required

Number of items per page

tenantId · string · required

Tenant ID

Example:

"14f1b308-d014-4842-908f-1902cfae4f63"

search · string

Search term to filter users or positions by name

Example:

"John Doe"

groupIds · string

Group IDs (comma separated)

Example:

"db895572-9c43-498b-91a6-19e331f8eace, 47562aa1-1006-4936-874d-ff671bd17e7b"

positionIds · string

Position IDs (comma separated)

Example:

"1c8e7178-b9ec-4e01-9489-3cd71a57598c, a50cd1df-a617-4f5d-b323-3955765ae542"

sortBy · enum<string>

Field to sort by

Available options: positions, users

Example:

"users"

sortOrder · enum<string> · default: asc

Sort order

Available options: asc, desc

Response

200 - application/json

Position personnel data retrieved successfully

statusCode · number · required

Example:

200

timestamp · string · required

Example:

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

message · string · required

Example:

"Success"

data · object

Show child attributes