Absence Registrations

Export absence registrations — sick leave, vacation, and other time-off records — for BI tools, payroll integrators, and HR systems.

Endpoint

GET /v1/absence-registrations

• Test: https://core-api.ditio.dev/reporting/v1/absence-registrations
• Production: https://core-api.ditio.app/reporting/v1/absence-registrations
• Scope: reportingapiv1 — see Authentication

Query parameters

In addition to the shared extraction filter (Pagination), the absence endpoint supports approval-state filters:

Parameter	Type	Description
FromDateTime	datetime	Earliest absence date to return (filters by absence date)
ToDateTime	datetime	Latest absence date to return
ModifiedSince	datetime	Incremental sync — only records modified at or after this instant
ModifiedBefore	datetime	Upper bound on modification date; requires ModifiedSince
Approved	bool	Filter by regular approval state
ApprovedPayroll	bool	Filter by payroll approval state
Locked	bool	Filter by lock state
CompanyId	string	Restrict to a specific company
ProjectId	string	Restrict to absences linked to a specific project
IncludeSensitiveData	bool	Whether to include sick-leave reason, child name/birthdate, etc.
ChunkLimit	int	Page size — default 2500, max 10000
ContinuationToken	string	Pagination cursor from the previous response

Sync modes

Mode	Triggered by	Sort order	Includes deletions?
Full	No ModifiedSince provided	By absence date	No
Incremental	ModifiedSince provided	By modification date	Yes — tombstones with isDeleted: true plus deletion metadata

For an integrator pulling absences into a downstream system: run a full sync once to backfill, then switch to incremental sync passing ModifiedSince = <last successful sync timestamp> on subsequent runs.

Record fields (selected)

Field	Description
id	Transaction id
date / qty	The absence day and hours on that day
absenceTypeId	Id of the absence type
absenceTypeCode	External code (the value mapped to payroll systems)
absenceTypeName	Display name
userId	Employee identity id
employeeNumber	Employee’s payroll number
projectId	Linked project (if any)
pdfUrl	Link to the generated absence PDF, null until generated — see PDF Extraction

Example

export DITIO_REPORTING_BASE="https://core-api.ditio.dev/reporting"  # test

curl -H "Authorization: Bearer $TOKEN" \
  "$DITIO_REPORTING_BASE/v1/absence-registrations?FromDateTime=2026-01-01&ToDateTime=2026-01-31"

⚠️ Production environment

Absence data is sensitive personal data — especially with IncludeSensitiveData=true (sick-leave reasons, child information). Only request sensitive fields if your integration genuinely needs them, and handle the data accordingly.

Pagination

Results are paginated using ContinuationToken. See Pagination.

Related

• Time Registrations — active work hours
• Payroll Lines — processed payroll data
• PDF Extraction — downloading the generated absence PDFs