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": "2025-06-25T06:16:49.192Z",
  "message": "Success",
  "data": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "data": [
      {
        "positionId": "7b9f1639-7491-441c-bee6-007dc88515ed",
        "position": "National Infrastructure Engineer",
        "users": "Domingo Lakin, Troy Weber, Judith Schumm"
      }
    ]
  }
}

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:

"ff354858-4a4f-401e-a18b-9519ffe2372e"

Search term to filter users or positions by name

Example:

"John Doe"

groupIds
string

Group IDs (comma separated)

Example:

"d279ecce-a763-4ec4-9391-5d1753facd83, 395377a1-4efa-41fd-9afb-b4df4fbb3d90"

positionIds
string

Position IDs (comma separated)

Example:

"4ba8762e-fec9-4853-962f-219c8b16eba7, ffb04e8f-10aa-4986-9e2b-8e688c1ee342"

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

The response is of type object.