Skip to main content
GET
/
v1
/
user
/
personnel
/
positions
Get positions with users
curl --request GET \
  --url https://staging.api.us.aptlydone.com/auth/v1/user/personnel/positions \
  --header 'Authorization: Bearer <token>'
{
  "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"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.aptlydone.com/llms.txt

Use this file to discover all available pages before exploring further.

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 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