v1

latestOpenAPI 3.1.02026-07-1274177461.2 KB

Positions

List Positions

get/unified/hris/positions

Query parameters

rawboolean nullable

Indicates that the raw request result should be returned in addition to the mapped result (default value is false)

proxyobject nullable

Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key

fieldsstring nullable

The comma separated list of fields to return in the response (if empty, all fields are returned)

updated_afterstring date-time nullable

Use a string with a date to only select results updated after that given date

Filter parameters that allow greater customisation of the list response

{
  "updated_after": "2020-01-01T00:00:00.000Z"
}

pagestring nullable

The page number of the results to fetch

page_sizestring nullable

The number of results per page (default value is 25)

nextstring nullable

The unified cursor

updated_afterstring date-time nullable

Example:2020-01-01T00:00:00.000Z

Use a string with a date to only select results updated after that given date

Example:open

Filter positions by status

Headers

x-account-idstring required

The account identifier

Preferstring

Example:heartbeat

Set to "heartbeat" to enable keep-alive newline heartbeats during long-running requests. Response includes Preference-Applied: heartbeat header when honored. (RFC 7240)

Response

The list of positions was retrieved.

next_pagestring nullable

nextstring nullable

Example response

{
  "data": [
    {
      "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "job_id": "JOB-12345",
      "title": "Senior Software Engineer",
      "description": "Responsible for developing and maintaining software applications",
      "department_id": "dept-123",
      "location_id": "loc-456",
      "employment_type": "full-time",
      "status": {
        "value": "open"
      },
      "posted_date": "2024-01-15T10:00:00.000Z"
    }
  ]
}