Skip to main content
GET
/
unified
/
hris
/
employees
List Employees
curl --request GET \
  --url https://api.stackone.com/unified/hris/employees \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'x-account-id: <x-account-id>'
{
  "data": [
    {
      "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "unified_custom_fields": {
        "my_project_custom_field_1": "REF-1236",
        "my_project_custom_field_2": "some other value"
      },
      "title": "Mr",
      "first_name": "Isaac",
      "last_name": "Newton",
      "name": "Isaac Newton",
      "display_name": "Sir Isaac Newton",
      "avatar_url": "https://example.com/avatar.png",
      "personal_email": "[email protected]",
      "personal_phone_number": "+1234567890",
      "work_email": "[email protected]",
      "work_phone_number": "+1234567890",
      "job_id": "5290",
      "job_title": "Physicist",
      "job_description": "Testing the laws of motion",
      "department_id": "3093",
      "department": "Physics",
      "groups": [
        {
          "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "unified_custom_fields": {
            "my_project_custom_field_1": "REF-1236",
            "my_project_custom_field_2": "some other value"
          },
          "name": "Engineering",
          "parent_ids": [
            "cxIQNjUyNDM0",
            "cxIQNjQzNzI0MQ"
          ],
          "remote_parent_ids": [
            "652434",
            "6437241"
          ],
          "owner_ids": [
            "cxIQNjUyEDM0",
            "cxIQNjQzNzA0MQ"
          ],
          "remote_owner_ids": [
            "475364",
            "4327652"
          ],
          "company_id": "1234567890",
          "remote_company_id": "1234567890",
          "type": {
            "value": "team",
            "source_value": "<string>"
          }
        }
      ],
      "cost_centers": [
        {
          "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "name": "R&D",
          "distribution_percentage": 100
        }
      ],
      "manager_id": "67890",
      "remote_manager_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48",
      "gender": "male",
      "preferred_language": "en_US",
      "ethnicity": "white",
      "date_of_birth": "1990-01-01T00:00:00.000Z",
      "birthday": "2021-01-01T00:00:00Z",
      "marital_status": "single",
      "avatar": "https://example.com/avatar.png",
      "hire_date": "2021-01-01T00:00:00.000Z",
      "start_date": "2021-01-01T00:00:00.000Z",
      "tenure": 2,
      "work_anniversary": "2021-01-01T00:00:00Z",
      "employment_type": "full_time",
      "employment_contract_type": "full_time",
      "employment_status": "active",
      "termination_date": "2021-01-01T00:00:00Z",
      "company_name": "Example Corp",
      "company_id": "1234567890",
      "citizenships": [
        {
          "value": "US",
          "source_value": "<string>"
        }
      ],
      "home_location": {
        "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "unified_custom_fields": {
          "my_project_custom_field_1": "REF-1236",
          "my_project_custom_field_2": "some other value"
        },
        "employee_id": "1687-3",
        "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48",
        "name": "Woolsthorpe Manor",
        "phone_number": "+44 1476 860 364",
        "street_1": "Water Lane",
        "street_2": "Woolsthorpe by Colsterworth",
        "city": "Grantham",
        "state": "Lincolnshire",
        "zip_code": "NG33 5NR",
        "country": {
          "value": "US",
          "source_value": "<string>"
        },
        "location_type": "work",
        "created_at": "2021-01-01T01:01:01.000Z",
        "updated_at": "2021-01-01T01:01:01.000Z"
      },
      "work_location": {
        "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "unified_custom_fields": {
          "my_project_custom_field_1": "REF-1236",
          "my_project_custom_field_2": "some other value"
        },
        "employee_id": "1687-3",
        "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48",
        "name": "Woolsthorpe Manor",
        "phone_number": "+44 1476 860 364",
        "street_1": "Water Lane",
        "street_2": "Woolsthorpe by Colsterworth",
        "city": "Grantham",
        "state": "Lincolnshire",
        "zip_code": "NG33 5NR",
        "country": {
          "value": "US",
          "source_value": "<string>"
        },
        "location_type": "work",
        "created_at": "2021-01-01T01:01:01.000Z",
        "updated_at": "2021-01-01T01:01:01.000Z"
      },
      "company": {
        "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "unified_custom_fields": {
          "my_project_custom_field_1": "REF-1236",
          "my_project_custom_field_2": "some other value"
        },
        "name": "StackOne Technologies PLC",
        "full_name": "American Express Company",
        "display_name": "StackOne",
        "created_at": "2023-02-23T00:00:00.000Z",
        "updated_at": "2024-02-23T00:00:00.000Z"
      },
      "employments": [
        {
          "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "unified_custom_fields": {
            "my_project_custom_field_1": "REF-1236",
            "my_project_custom_field_2": "some other value"
          },
          "job_title": "Software Engineer",
          "pay_rate": "40.00",
          "pay_period": "monthly",
          "pay_frequency": "hourly",
          "pay_currency": "USD",
          "effective_date": "2021-01-01T01:01:01.000Z",
          "end_date": "2021-01-01T01:01:01.000Z",
          "grade": {
            "id": "1687-3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "name": "1687-4",
            "description": "Mid-level employee demonstrating proficiency and autonomy."
          },
          "employment_type": "permanent",
          "employment_contract_type": "full_time",
          "type": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "label": "Permanent",
            "type": "permanent"
          },
          "contract_type": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "label": "Full-Time",
            "contract_type": "full_time"
          },
          "work_time": {
            "duration": "P0Y0M0DT8H0M0S",
            "period": "month"
          },
          "payroll_code": "PC1",
          "employee_id": "1687-3",
          "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48",
          "fte": "1",
          "created_at": "2021-01-01T01:01:01.000Z",
          "updated_at": "2021-01-01T01:01:01.000Z",
          "start_date": "2021-01-01T01:01:01.000Z",
          "active": true,
          "department": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "unified_custom_fields": {
              "my_project_custom_field_1": "REF-1236",
              "my_project_custom_field_2": "some other value"
            },
            "name": "Engineering",
            "parent_ids": [
              "cxIQNjUyNDM0",
              "cxIQNjQzNzI0MQ"
            ],
            "remote_parent_ids": [
              "652434",
              "6437241"
            ],
            "owner_ids": [
              "cxIQNjUyEDM0",
              "cxIQNjQzNzA0MQ"
            ],
            "remote_owner_ids": [
              "475364",
              "4327652"
            ],
            "company_id": "1234567890",
            "remote_company_id": "1234567890",
            "type": {
              "value": "team",
              "source_value": "<string>"
            }
          },
          "cost_center": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "unified_custom_fields": {
              "my_project_custom_field_1": "REF-1236",
              "my_project_custom_field_2": "some other value"
            },
            "name": "Engineering",
            "parent_ids": [
              "cxIQNjUyNDM0",
              "cxIQNjQzNzI0MQ"
            ],
            "remote_parent_ids": [
              "652434",
              "6437241"
            ],
            "owner_ids": [
              "cxIQNjUyEDM0",
              "cxIQNjQzNzA0MQ"
            ],
            "remote_owner_ids": [
              "475364",
              "4327652"
            ],
            "company_id": "1234567890",
            "remote_company_id": "1234567890",
            "type": {
              "value": "team",
              "source_value": "<string>"
            }
          },
          "cost_centers": [
            {
              "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
              "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
              "unified_custom_fields": {
                "my_project_custom_field_1": "REF-1236",
                "my_project_custom_field_2": "some other value"
              },
              "name": "Engineering",
              "parent_ids": [
                "cxIQNjUyNDM0",
                "cxIQNjQzNzI0MQ"
              ],
              "remote_parent_ids": [
                "652434",
                "6437241"
              ],
              "owner_ids": [
                "cxIQNjUyEDM0",
                "cxIQNjQzNzA0MQ"
              ],
              "remote_owner_ids": [
                "475364",
                "4327652"
              ],
              "company_id": "1234567890",
              "remote_company_id": "1234567890",
              "distribution_percentage": 85,
              "type": {
                "value": "team",
                "source_value": "<string>"
              }
            }
          ],
          "division": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "unified_custom_fields": {
              "my_project_custom_field_1": "REF-1236",
              "my_project_custom_field_2": "some other value"
            },
            "name": "Engineering",
            "parent_ids": [
              "cxIQNjUyNDM0",
              "cxIQNjQzNzI0MQ"
            ],
            "remote_parent_ids": [
              "652434",
              "6437241"
            ],
            "owner_ids": [
              "cxIQNjUyEDM0",
              "cxIQNjQzNzA0MQ"
            ],
            "remote_owner_ids": [
              "475364",
              "4327652"
            ],
            "company_id": "1234567890",
            "remote_company_id": "1234567890",
            "type": {
              "value": "team",
              "source_value": "<string>"
            }
          },
          "job": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "title": "Software Engineer",
            "description": {
              "text": "Testing the laws of motion"
            },
            "owner_id": "5356",
            "parent_id": "7577"
          },
          "manager": [
            {
              "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
              "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
              "name": "John Doe",
              "email": "[email protected]",
              "role": {
                "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
                "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
                "label": "Admin",
                "role_type": "admin"
              }
            }
          ]
        }
      ],
      "custom_fields": [
        {
          "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "name": "Training Completion Status",
          "value": "Completed",
          "value_id": "value_456",
          "remote_value_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48"
        }
      ],
      "benefits": [
        {
          "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "name": "Health Insurance",
          "benefit_type": {
            "value": "retirement_savings",
            "source_value": "<string>"
          },
          "provider": "Aetna",
          "description": "Health insurance for employees",
          "created_at": "2021-01-01T00:00:00Z",
          "updated_at": "2021-01-01T00:00:00Z"
        }
      ],
      "employee_number": "125",
      "bank_details": [
        {
          "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "account_name": "John Doe Primary Account",
          "is_primary": true,
          "country_code": {
            "value": "US",
            "source_value": "<string>"
          },
          "currency_code": {
            "value": "USD",
            "source_value": "USD"
          },
          "bank_name": "Chase Bank",
          "account_type": {
            "value": "checking",
            "source_value": "checking"
          },
          "iban": "GB82WEST12345698765432",
          "local_account_number": "1234567890",
          "swift_bic": "CHASUS33",
          "clearing_codes": [
            {
              "type": {
                "value": "sort_code",
                "source_value": "sort_code"
              },
              "value": "12-34-56"
            }
          ]
        }
      ],
      "national_identity_number": {
        "value": "123456789",
        "type": {
          "value": "ssn",
          "source_value": "<string>"
        },
        "country": {
          "value": "US",
          "source_value": "<string>"
        }
      },
      "national_identity_numbers": [
        {
          "value": "123456789",
          "type": {
            "value": "ssn",
            "source_value": "<string>"
          },
          "country": {
            "value": "US",
            "source_value": "<string>"
          }
        }
      ],
      "skills": [
        {
          "id": "16873-IT345",
          "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
          "name": "Information-Technology",
          "active": true,
          "language": {
            "value": "en_GB",
            "source_value": "<string>"
          },
          "maximum_proficiency": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "name": "Expert",
            "value": "1",
            "source_value": "<string>"
          },
          "minimum_proficiency": {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "name": "Expert",
            "value": "1",
            "source_value": "<string>"
          }
        }
      ],
      "created_at": "2021-01-01T01:01:01.000Z",
      "updated_at": "2021-01-01T01:01:01.000Z"
    }
  ],
  "next_page": "<string>",
  "next": "<string>",
  "raw": [
    {
      "method": "<string>",
      "url": "<string>",
      "body": {},
      "response": {}
    }
  ]
}

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

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 that will be returned in the response (if empty, all fields are returned)

Example:

"id,remote_id,title,first_name,last_name,name,display_name,gender,ethnicity,date_of_birth,birthday,marital_status,avatar_url,avatar,personal_email,personal_phone_number,work_email,work_phone_number,job_id,remote_job_id,job_title,job_description,department_id,remote_department_id,department,cost_centers,company,manager_id,remote_manager_id,hire_date,start_date,tenure,work_anniversary,employment_type,employment_contract_type,employment_status,termination_date,company_name,company_id,remote_company_id,preferred_language,citizenships,home_location,work_location,employments,custom_fields,created_at,updated_at,benefits,employee_number,national_identity_number,national_identity_numbers,bank_details,skills,unified_custom_fields"

filter
object

HRIS Employees filters

page
string | null

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<date-time> | null

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

Example:

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

expand
string | null

The comma separated list of fields that will be expanded in the response

Example:

"company,employments,work_location,home_location,groups,skills"

include
string | null

The comma separated list of fields that will be included in the response

Example:

"avatar_url,avatar,custom_fields,job_description,benefits,bank_details"

Response

The list of employees was retrieved.

data
object[]
required
next_page
string | null
deprecated
next
string | null
raw
object[] | null