GET
/
unified
/
hris
/
positions
List Positions
curl --request GET \
  --url https://api.stackone.com/unified/hris/positions \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'x-account-id: <x-account-id>'
{
  "next_page": "<string>",
  "next": "<string>",
  "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",
        "source_value": "<string>"
      },
      "posted_date": "2024-01-15T10:00:00.000Z"
    }
  ],
  "raw": [
    {
      "method": "<string>",
      "url": "<string>",
      "body": "<string>",
      "response": {}
    }
  ]
}
This endpoint is currently in beta and subject to change before full release.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
x-account-id
string
required

The account identifier

Query Parameters

​
raw
boolean | null

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

​
proxy
object | null

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

​
fields
string | null

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

​
filter
object | null

Filter parameters that allow greater customisation of the list response

​
page
string | null
deprecated

The page number of the results to fetch

​
page_size
string | null

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

​
next
string | null

The unified cursor

​
updated_after
string | null
deprecated

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

Example:

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

​
status
enum<string> | null

Filter positions by status

Available options:
open,
closed,
paused,
unmapped_value
Example:

"open"

Response

200
application/json

The list of positions was retrieved.

The response is of type object.