---
title: "Reads all Incidences"
method: GET
path: "/api/2026-10-01/resources/bookkeepers_management/incidences"
tags: ["BookkeepersManagement > Incidence"]
---

# Reads all Incidences

`GET /api/2026-10-01/resources/bookkeepers_management/incidences`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/bookkeepers_management/incidences`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `employee_updates`
  - API key in header `x-api-key`

Reads all Incidences

## Query parameters

- `ids[]` string[]: A list of incidence identifiers.
- `legal_entities_ids[]` string[]: A list of legal entities identifiers.
- `status[]` string[]: A list of statuses.
- `starts_on` string: Get the incidence (aka employee update) that start safter this date (included).
- `ends_on` string: Get the incidence (aka employee update) that ends before this date (included).
- `type[]` string[]: A list of types. It can be any of the following address, bank, cost_center, contract, gender, health_insurance, hiring, id, irpf, legal_entity, manual_incidence, name, nationality, parental, permits_and_certificates, phone_number, sick, tax_id, taxes_and_deductions, termination, work_activity, workplace
- `sort_by` string: Field to sort by. It can be any of the following employee_first_name, employee_last_name, type, legal_entity_name, effective_date, status, created_at.
- `direction` string: Sort direction. It can be 'asc' or 'desc'.
- `search` string: Filter the result by the name of the employee.
- `employee_ids[]` string[]: A list of employee identifiers.
- `contains_message` boolean: Boolean that filters incidences that does or does not contains messages.
- `message_from` string: Filter by message sender.
- `custom_leave_name[]` string[]: A list of custom leave names.

## Response `200`

OK

- object
  - `data` BookkeepersManagementIncidence[]
    - `id` string, required: identifier of the incidence (aka employee update).
    - `employee_id` string: identifier of employee related.
    - `legal_entity_id` string, required: identifier of legal entity related.
    - `name` string, required: name of the incidence (aka employee update). It also represent the incidence type. For example a new hire incidence will be
    - `custom_name` string
    - `target_id` string, required: The incidence (aka employee update) is also related to a another resource, for example for a leave target, the target identifier will be the leave id.
    - `target_type` string, required: The incidence (aka employee update) is also related to a another resource, for example a leave. This is the target type. The other types are Employee, Contracts::ContractVersion, BookkeepersManagement::ManualIncidence, Finance::CostCenterMembership.
    - `starts_on` string: The date the incidence (aka employee update) starts.
    - `ends_on` string: The date the incidence (aka employee update) end.
    - `read_at` string: The date the incidence (aka employee update) was read.
    - `status` string, required
    - `company_id` string, required: identifier of company related.
    - `message_from` string: Indicate the message sender on the incidence (aka employee update). It can be any of 'bookkeeper', 'admin'
    - `has_message` boolean: Boolean that indicates if the incidence (aka employee update) has unread messages.
    - `created_at` string, required: Date in which incidence (aka employee update) was created.
    - `is_reopened` boolean, required: Boolean that indicates if the incidence (aka employee update) has been reopened.
    - `legal_entity_name` string
    - `employee_first_name` string
    - `employee_last_name` string
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/bookkeepers_management/incidences/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)