---
title: "Search absences"
method: POST
path: "/v1/organizations/{orgId}/absences/search"
tags: ["Absences"]
---

# Search absences

`POST /v1/organizations/{orgId}/absences/search`

## Request

- Base URL: `https://api.timesheet.io`
- URL: `https://api.timesheet.io/v1/organizations/{orgId}/absences/search`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

## Path parameters

- `orgId` string, required

## Request body

- AbsenceListParams
  - `search` string
  - `sort` string
  - `order` string
  - `count` integer
  - `page` integer
  - `limit` integer
  - `organizationId` string
  - `contractId` string
  - `userId` string
  - `absenceTypeId` string
  - `status` string
  - `startDate` string
  - `endDate` string
  - `year` integer
  - `userIds` string[]
  - `contractIds` string[]
  - `statuses` string[]
  - `teamId` string
  - `teamIds` string[]
  - `excludeRejectedCancelled` boolean
  - `includeInactive` boolean
  - `offset` integer

## Response `200`

Search results

- AbsenceList
  - `items` AbsenceDto[]
    - `id` string
    - `contractId` string
    - `member` Member
      - `uid` string
      - `firstname` string
      - `lastname` string
      - `email` string
      - `employeeId` string
      - `imageUrl` string
      - `deleted` boolean
      - `activity` Activity
        - `projectId` string
        - `projectTitle` string
        - `projectColor` integer
        - `taskId` string
        - `startDateTime` string
        - `endDateTime` string
        - `location` string
        - `running` boolean
      - `displayName` string
      - `initials` string
    - `absenceTypeId` string
    - `absenceType` AbsenceTypeDto
      - `id` string
      - `organizationId` string
      - `code` string
      - `i18nKey` string
      - `name` string
      - `descriptionI18nKey` string
      - `description` string
      - `color` integer
      - `icon` string
      - `paid` boolean
      - `requiresApproval` boolean
      - `requiresDocumentation` boolean
      - `documentationRequiredAfterDays` integer
      - `affectsOvertime` boolean
      - `deductsFromQuota` boolean
      - `maxConsecutiveDays` integer
      - `minNoticeDays` integer
      - `countryCode` string
      - `systemType` boolean
      - `active` boolean
      - `sortOrder` integer
      - `lastUpdate` integer
      - `created` integer
    - `startDateTime` string
    - `endDateTime` string
    - `fullDay` boolean
    - `totalDays` string, decimal
    - `totalHours` string, decimal
    - `reason` string
    - `documentationUrl` string
    - `fileName` string
    - `fileUri` string
    - `status` string
    - `requestedAt` integer
    - `requestedBy` string
    - `requestedByMember` Member
      - `uid` string
      - `firstname` string
      - `lastname` string
      - `email` string
      - `employeeId` string
      - `imageUrl` string
      - `deleted` boolean
      - `activity` Activity
        - `projectId` string
        - `projectTitle` string
        - `projectColor` integer
        - `taskId` string
        - `startDateTime` string
        - `endDateTime` string
        - `location` string
        - `running` boolean
      - `displayName` string
      - `initials` string
    - `approvedBy` string
    - `approvedAt` integer
    - `rejectionReason` string
    - `cancelledAt` integer
    - `cancelledBy` string
    - `cancellationReason` string
    - `canApprove` boolean
    - `canReject` boolean
    - `canCancel` boolean
    - `canEdit` boolean
    - `documentationStatus` string
    - `documentationDueDate` string
    - `lastUpdate` integer
    - `created` integer
  - `params` AbsenceListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `organizationId` string
    - `contractId` string
    - `userId` string
    - `absenceTypeId` string
    - `status` string
    - `startDate` string
    - `endDate` string
    - `year` integer
    - `userIds` string[]
    - `contractIds` string[]
    - `statuses` string[]
    - `teamId` string
    - `teamIds` string[]
    - `excludeRejectedCancelled` boolean
    - `includeInactive` boolean
    - `offset` integer

## Other responses

- `401`: Not authorized

## Changes

> 14 revisions in range; 1 not diffed.

- **2026-10-05** `8290cf15248f`: 4 info
  - added the new optional request property `includeInactive` (media type: application/json)
  - added the new optional request property `includeInactive` (media type: application/xml)
  - added the optional property `params/includeInactive` to the response with the `200` status (media type: application/json)
  - added the optional property `params/includeInactive` to the response with the `200` status (media type: application/xml)

[Operation history](https://skmtc.dev/timesheet/apis/timesheet-api/changes/v1/organizations/:orgId/absences/search/post.md)

---

[API](https://skmtc.dev/timesheet/apis/timesheet-api.md) - [All operations](https://skmtc.dev/timesheet/apis/timesheet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timesheet/apis/timesheet-api/revisions/2f6595c95dc4?raw)