Skip to main content
GET
Get position
Returns one homed, visible position and its safe current-assignment summary. A vacant position has null currentAssignment; a missing worker retains the assignment’s workerId with null person/name/type enrichment. Hidden reporting references are null. Missing, invisible and unhomed rows, including a position homed in or under a customer organization, all return 404; component or mapper faults remain server failures.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

positionId
string
required
Minimum string length: 1

Response

Success

data
object
required
meta
object
required