# Absences

**Beta:**
Salaxy API v04 is in beta: it may change, and it is not used in production yet. Build on v03, the current version.

Absences Controller provides CRUD functionality as well as additional methods for Absences objects

Salaxy API v04 (beta), **Finland only**. 8 operations. Interactive version: [REST API reference](https://code.salaxy.com/reference/rest-api-v04.md). Machine-readable: [OpenAPI document](https://code.salaxy.com/openapi/salaxy-04.json).

**The reference wins:**
These pages are generated from the OpenAPI document. If a guide and this reference disagree about a field, follow the reference. Error responses are not in the document — see [Errors](https://code.salaxy.com/reference/errors.md).

## `GET /v04/api/absences`

**Performs an OData query to the search index.**

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `$search` | query | string |  |  |
| `$filter` | query | string |  | Specifies the logic to pull back a subset of records. |
| `$orderby` | query | string |  | Specifies the values used to sort the collection of entries. |
| `$select` | query | string |  | The $select system query option allows the clients to requests a limited set of properties for each entry. |
| `$top` | query | number |  | Specifies the subset of entries by count. |
| `$skip` | query | number |  | Specifies the count of entries to skip. |
| `$count` | query | boolean |  | Indicates whether or not to include a total entry count. |

Response: `PageResultOfApiListItem`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/GET/v04/api/absences)

## `POST /v04/api/absences`

**Updates or creates a new object**

Request body: `WorkerAbsences` (required)

Response: `WorkerAbsences`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/POST/v04/api/absences)

## `GET /v04/api/absences/{id}`

**Gets a single object based on identier**

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | Unique identifier for the object |

Response: `WorkerAbsences`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/GET/v04/api/absences/{id})

## `DELETE /v04/api/absences/{id}`

**Deletes a Absences object from the storage**

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | Unique identifier for the object. |

Response: `string`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/DELETE/v04/api/absences/{id})

## `GET /v04/api/absences/new`

**Factory method that creates a new object**

Response: `WorkerAbsences`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/GET/v04/api/absences/new)

## `GET /v04/api/absences/latest`

**Gets latest Absences objects.**

Response: `WorkerAbsences[]`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/GET/v04/api/absences/latest)

## `GET /v04/api/absences/employment/{employmentId}`

**Gets the Absences object for a specific Employment relation.**

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `employmentId` | path | string | yes | The employment relation for which to list the Absences. |

Response: `WorkerAbsences`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/GET/v04/api/absences/employment/{employmentId})

## `GET /v04/api/absences/employment/set`

**Returns Absences objects for given Employment relations.**

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `employmentIds` | query | string[] |  | Set of employmentIds for which to get the Absences objects. |

Response: `WorkerAbsences[]`

Try it: [interactive reference](https://code.salaxy.com/reference/rest-api-v04.md#tag/absences/GET/v04/api/absences/employment/set)
