Fields
| Field | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Twine-internal identifier |
org_id | UUID | Yes | Organisation identifier |
employee_id | UUID | Yes | The employee this record belongs to |
start_date | date | Yes | Inclusive start date of the record |
end_date | date | Yes | Inclusive end date of the record |
source_external_time_type_id | string | Yes | The time type identifier from the source system |
source_system_slug | string | Yes | Identifies which system the record originated from |
request_status | enum | No | Approval state - see below |
minutes | integer[] | No | Duration in minutes, one entry per workday within the date range |
extent | number[] | No | Duration as a fraction of the workday, one entry per workday. Not available for all systems. |
from_time | string | No | Clock start time (HH:MM). Not available for all systems. |
to_time | string | No | Clock end time (HH:MM). Not available for all systems. |
comment | string | No | Free-text comment |
child_id | string | No | Remote identifier of the child for child-related leave types. Not available for all systems. |
child_name | string | No | Name of the child for child-related leave types. Not available for all systems. |
inserted_at | datetime | Yes | Timestamp of when the record was created in Twine |
Request status
| Value | Description |
|---|---|
approved | The request has been approved |
requested | Submitted and awaiting approval |
pending | Pending action |
rejected | The request was rejected |
cancelled | The request was cancelled |
unknown | The status could not be determined from the source system |
Time types
Every time report references a time type that describes what kind of absence or attendance is being recorded - vacation, sick leave, parental leave, and so on. Time types can be sourced from the external system or defined locally within Twine. Each time type has a name, an optional code, and an optional external identifier. Its behaviour is described by a set of traits:| Trait | Type | Description |
|---|---|---|
unit | enum | The unit in which this type is reported: day, hour, or minute |
enabled | boolean | Whether this time type is currently active |
must_be_full_day | boolean | When unit is not day, whether records must still span full days. Not available for all systems. |
comment_as_child_name | boolean | Whether the comment field should be treated as a child’s name, used for parental leave reporting in some systems. |