Time Registrations

Export time registrations (hours logged by field workers) from Ditio. This is the most commonly used Data Extraction endpoint.

Endpoint

GET /v1/time-registrations

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

Query parameters

The endpoint uses the shared extraction filter — see Pagination for the full list:

Parameter	Type	Description
FromDateTime	datetime	Full-sync window start, e.g. 2026-01-01
ToDateTime	datetime	Full-sync window end
ModifiedSince	datetime	Incremental sync — records created or modified since this instant
ModifiedBefore	datetime	Optional upper bound; requires ModifiedSince
ProjectId	string	Restrict to one project
CompanyId	string	Only data registered in this company
ChunkLimit	int	Page size — default 2500, range 1–10000
ContinuationToken	string	Pagination cursor from the previous response

Response

{
  "data": [],
  "links": { "next": "/v1/time-registrations?...&ContinuationToken=eyJ..." },
  "continuationToken": "eyJ..."
}

Records include the worker, project, work order, times/quantities, and approval state. For the exhaustive field list, inspect a response from the test environment against your own data.

Example

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

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

Pagination

Results are paginated using ContinuationToken. See Pagination for the loop and for incremental sync with ModifiedSince.

Related

• Export Time Data guide — step-by-step integration walkthrough
• Payroll Lines — post-approval payroll data
• Absence Registrations — time off rather than hours worked