Sign in

3f26defa2a42

latestOpenAPI 3.0.02026-07-24161168406.5 KB
Position
Position

List positions with filtering and pagination

Retrieves a paginated list of positions with optional filtering by name, status, area, role, parent position, and other criteria. Supports both UUID-based and name/code-based filtering.

get/os/v1/positions

Query parameters

namestring
Example:Developer

Position name to filter

externalCodestring
Example:DEV001

Position external code to filter

status'OPEN' | 'FILLED' | 'CLOSED' | 'FROZEN'

Position status to filter

areaUuidstring uuid
Example:d20dc017-80c6-4706-bbfe-549c1cc4d2c1

Area UUID to filter

roleUuidstring uuid
Example:d20dc017-80c6-4706-bbfe-549c1cc4d2c1

Role UUID to filter

parentUuidstring uuid
Example:d20dc017-80c6-4706-bbfe-549c1cc4d2c1

Parent position UUID to filter

areaNamestring
Example:Technology

Area name to filter (exact match)

areaExternalCodestring
Example:TECH-001

Area external code to filter (exact match)

roleNamestring
Example:Developer

Role name to filter (exact match)

roleExternalCodestring
Example:DEV-001

Role external code to filter (exact match)

parentNamestring
Example:Manager

Parent position name to filter (exact match)

parentExternalCodestring
Example:MGR-001

Parent position external code to filter (exact match)

pagenumber
Example:1

Page number for pagination

maxPageSizenumber
Example:20

Maximum page size for pagination

Response

Positions retrieved successfully