---
title: "Find employment term assignments"
method: GET
path: "/employment-term-assignments"
tags: ["employment-term-assignments"]
---

# Find employment term assignments

`GET /employment-term-assignments`

## Request

- Base URL: `https://api.hoorayhr.io`
- URL: `https://api.hoorayhr.io/employment-term-assignments`
- Auth: API key in header `authorization`

Retrieves a list of all resources from the service.

## Response `200`

success

- EmploymentTermAssignments[]
  - `id` integer: Unique id of the employment term assignment
  - `userId` integer: The user the employment term is assigned to
  - `employmentTermId` integer: The ID of the employment term
  - `startDate` string, date: The start date of the employment term assignment. Or the termination date, if `isTerminated` is set to `true`
  - `currency` string, nullable: A [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) string indicating the currency of the employment term assignment. It's only required for employment terms of type 'CURRENCY'.
  - `value` union: Value of the employment term assignment. Terminated assignments do not have a value
    - string, nullable: Only for employment terms of type: `TEXT`
    - boolean, nullable: Only for employment terms of type: `BOOLEAN`
    - number, nullable: Only for employment terms of type: `NUMBER` or `CURRENCY`
  - `isTerminated` boolean: Whether the employment term assignment is terminated
  - `status` 'INACTIVE' | 'ACTIVE' | 'FUTURE': Status of the employment term assignment. Assignments that start in the future have status `FUTURE`. All other assignments are `ACTIVE`, unless they either precede another assignment, or if the user's employment has finished, in which case they are `INACTIVE`.
  - `salarySubTypeId` integer, nullable: The salary sub type ID the employment term assignment is linked to. Only applicable for assignments linked to the `SALARY` system employment term. See the `salarySubTypes` list on the salary employment term for a list of possible values
  - `note` string, nullable: Optional note for the employment term assignment
  - `createdAt` string, date-time: Creation date of the employment term assignment
  - `updatedAt` string, date-time: Last updated date of the employment term assignment

## Other responses

- `401`: not authenticated
- `500`: general error

---

[API](https://skmtc.dev/hoorayhr/apis/hoorayhr-api-documentation.md) · [All operations](https://skmtc.dev/hoorayhr/apis/hoorayhr-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/hoorayhr/apis/hoorayhr-api-documentation/revisions/3adcd47cd827?raw)