---
title: "List absences 🌍"
method: GET
path: "/companies/{companyId}/absences"
tags: ["Absences"]
---

# List absences 🌍

`GET /companies/{companyId}/absences`

Returns the absences in a company. This list is paginated. The output can be filtered given some fields like contractId. By default, only approved absences are returned, but this can be changed by setting `status` filter.

\
**Required scopes**: *time:read*

## Path parameters

- `companyId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` string
- `contractId` string
- `status` string
- `beginDate` string, date
- `endDate` string, date

## Response `200`

The absences of the collaborators in the company.

- object
  - `absences` object[], required
    - `id` string, required — Id of the absence.
    - `contractId` string, required — Contract ID of the absence owner.
    - `startDate` object, required — Date and moment of the day when the absence starts.
      - `date` string, date, required — Date of the absence in the format YYYY-MM-DD
      - `moment` 'beginning-of-day' | 'middle-of-day' | 'end-of-day', required — Moment of the day when the absence starts.
    - `endDate` object, required — Date and moment of the day when the absence ends.
      - `date` string, date, required — Date of the absence in the format YYYY-MM-DD
      - `moment` 'beginning-of-day' | 'middle-of-day' | 'end-of-day', required — Moment of the day when the absence ends.
    - `type` 'fr_adoption' | 'fr_conges_payes' | 'fr_rtt' | 'fr_absence_remuneree' | 'fr_repos' | 'fr_sans_solde' | 'fr_maladie_ordinaire' | 'fr_accident_travail' | 'fr_accident_trajet' | 'fr_maladie_professionnelle' | 'fr_temps_partiel_therapeutique' | 'fr_paternite' | 'fr_maternite' | 'fr_second_parent' | 'fr_pathologique' | 'fr_naissance' | 'fr_enfant_malade' | 'fr_parental_education' | 'fr_mariage' | 'fr_deces' | 'fr_deuil' | 'fr_mise_a_pied' | 'fr_activite_partielle' | 'fr_autre' | 'fr_ecole' | 'uk_annual_leave' | 'uk_maternity' | 'uk_paternity' | 'uk_kit' | 'uk_adoption' | 'uk_sick_leave' | 'uk_covid' | 'uk_paid_leave' | 'uk_jury_service' | 'uk_unpaid_leave' | 'uk_compassionate_leave' | 'uk_bereavement_leave' | 'es_vacaciones' | 'es_visita_medica' | 'es_asunto_personal' | 'es_asunto_familiar' | 'es_cuidado_de_hijos' | 'es_permisos' | 'es_compensacion_dias_trabajados' | 'es_baja_medica' | 'es_otros' | 'colleague_leave' | 'colleague_partial_leave' | 'colleague_school' | 'other', required — Type of absences. Other is used when the type is not yet defined.
    - `status` 'approved' | 'pending_approval' | 'declined' | 'cancelled' | 'pending_cancellation', required
  - `meta` object
    - `nextPageToken` string, nullable
    - `count` integer, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/payfit/apis/partner-api.md) · [All operations](https://skmtc.net/payfit/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payfit/partner-api/revisions/fd1fb9262946/schema)