AbsenceDays5

AbsenceReasons6

Absences7

Adoptions2

BankDetails5

Benefits6

Calendar1

EmergencyContacts5

Employees13

Entitlements2

Hierarchy4

Jobs5

Maternities2

Paternities2

Positions4

PublicHolidays3

UserDefinedFields3

UserDefinedFieldSchemas2

WorkingPatternComponents3

WorkingPatternOverride1

WorkingPatternOverrideComponents5

WorkingPatterns2

Absences

Gets a single Absence referenced by ID.

Changed on Nov 10, 2026

get/attendance/absences/{id}

Request

Base URL
https://api.iris.co.uk/hr/v2
Auth
OAuth 2
Client credentials
Token URLhttps://api.iris.co.uk/oauth2/v1/token
TypeScript
https://skmtc.dev/hrapi/apis/hr-api/docs/attendance/absences/:id/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Absence ID.

Response

EmployeeIdstring nullable required

The ID of the Employee.

Must exist in the Employees Service.

Cannot be updated once Absence created.

AbsenceReasonIdstring required

The Absence Reason ID.

Must exist in the Attendance Absence Reasons Service.

When updating the Absende Reason Parent Id cannot change.

Narrativestring nullable

The Narrative relating to the Attendance.

Cascade Source:

[EmployeeAttendance].[Narrative] if Absence Reason is not Shared Parental Leave

'Shared Parental Leave - ' + [EmployeeSharedParentalLeave].[LeaveType] + ' - ' + [EmployeeSharedParentalLeave].[WhoseLeaveIsIt] if Absence Reason is Shared Parental Leave

StartDatestring date-time nullable

The Start Date of the Attendance.

Cascade Source:

[EmployeeAttendance].[StartDate] if Absence Reason is not Shared Parental Leave

[EmployeeSharedParentalLeave].[LeaveStartDate] if Absence Reason is Shared Parental Leave

EndDatestring date-time nullable

The End Date of the Attendance.

Cascade Source:

[EmployeeAttendance].[EndDate] if Absence Reason is not Shared Parental Leave

Null if Opened Ended - Cascade Source: [EmployeeAttendance].[OpenEnded]

[EmployeeSharedParentalLeave].[LeaveEndDate] if Absence Reason is Shared Parental Leave

SourceSystemIdstring nullable

Source HR System Id.

Cascade Source:

[EmployeeAttendance].[RUID] if Absence Reason is not Shared Parental Leave

[EmployeeSharedParentalLeave].[Ruid] if Absence Reason is Shared Parental Leave

SourceSystemCreatedOnstring date-time nullable

The date when the Absence was created in the Source HR System.

Cascade Source:

[EmployeeAttendance].[SYS_EffectiveDate] if Absence Reason is not Shared Parental Leave

[EmployeeSharedParentalLeave].[SYS_EffectiveDate] if Absence Reason is Shared Parental Leave

SourceSystemLastModifiedOnstring date-time nullable

The date when the Absence was created or last updated in the Source HR System.

Cascade Source:

[EmployeeAttendance].[SYS_ModifiedDate] if Absence Reason is not Shared Parental Leave

[EmployeeSharedParentalLeave].[SYS_ModifiedDate] if Absence Reason is Shared Parental Leave

Idstring nullable

This ID is generated by the Iris HR platform and does not relate to the Cascade ID.

CreatedOnstring date-time

The date when the Absence was created in the Iris HR platform.

CreatedBystring nullable

Not used as the Iris HR platform has no concept of users.

LastModifiedOnstring date-time nullable

The date when the Absence was created or last updated.

LastModifiedBystring nullable

Not used as the Iris HR platform has no concept of users.

Changes

Nov 10, 2026638d402d3872 Revision changes
- breaking
  added the pattern ^[0-9a-fA-F-]{36}$ to the path request parameter id
- warning
  for the path request parameter id, the maxLength was set to 36
Oct 6, 20267a4734dbe370 Revision changes
- info
  media type application/json; version=1 was changed to application/json for the response status
- info
  media type application/json; version=1 was changed to application/json for the response status
- info
  media type application/json; version=1 was changed to application/json for the response status
- info
  media type application/json;odata.metadata=full; version=1 was changed to application/json;odata.metadata=full for the response status
- info
  media type application/json;odata.metadata=full; version=1 was changed to application/json;odata.metadata=full for the response status
- info
  media type application/json;odata.metadata=full; version=1 was changed to application/json;odata.metadata=full for the response status
- info
  media type application/json;odata.metadata=full;odata.streaming=false; version=1 was changed to application/json;odata.metadata=full;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=full;odata.streaming=false; version=1 was changed to application/json;odata.metadata=full;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=full;odata.streaming=false; version=1 was changed to application/json;odata.metadata=full;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=full;odata.streaming=true; version=1 was changed to application/json;odata.metadata=full;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=full;odata.streaming=true; version=1 was changed to application/json;odata.metadata=full;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=full;odata.streaming=true; version=1 was changed to application/json;odata.metadata=full;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=minimal; version=1 was changed to application/json;odata.metadata=minimal for the response status
- info
  media type application/json;odata.metadata=minimal; version=1 was changed to application/json;odata.metadata=minimal for the response status
- info
  media type application/json;odata.metadata=minimal; version=1 was changed to application/json;odata.metadata=minimal for the response status
- info
  media type application/json;odata.metadata=minimal;odata.streaming=false; version=1 was changed to application/json;odata.metadata=minimal;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=minimal;odata.streaming=false; version=1 was changed to application/json;odata.metadata=minimal;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=minimal;odata.streaming=false; version=1 was changed to application/json;odata.metadata=minimal;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=minimal;odata.streaming=true; version=1 was changed to application/json;odata.metadata=minimal;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=minimal;odata.streaming=true; version=1 was changed to application/json;odata.metadata=minimal;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=minimal;odata.streaming=true; version=1 was changed to application/json;odata.metadata=minimal;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=none; version=1 was changed to application/json;odata.metadata=none for the response status
- info
  media type application/json;odata.metadata=none; version=1 was changed to application/json;odata.metadata=none for the response status
- info
  media type application/json;odata.metadata=none; version=1 was changed to application/json;odata.metadata=none for the response status
- info
  media type application/json;odata.metadata=none;odata.streaming=false; version=1 was changed to application/json;odata.metadata=none;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=none;odata.streaming=false; version=1 was changed to application/json;odata.metadata=none;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=none;odata.streaming=false; version=1 was changed to application/json;odata.metadata=none;odata.streaming=false for the response status
- info
  media type application/json;odata.metadata=none;odata.streaming=true; version=1 was changed to application/json;odata.metadata=none;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=none;odata.streaming=true; version=1 was changed to application/json;odata.metadata=none;odata.streaming=true for the response status
- info
  media type application/json;odata.metadata=none;odata.streaming=true; version=1 was changed to application/json;odata.metadata=none;odata.streaming=true for the response status
- info
  media type application/json;odata.streaming=false; version=1 was changed to application/json;odata.streaming=false for the response status
- info
  media type application/json;odata.streaming=false; version=1 was changed to application/json;odata.streaming=false for the response status
- info
  media type application/json;odata.streaming=false; version=1 was changed to application/json;odata.streaming=false for the response status
- info
  media type application/json;odata.streaming=true; version=1 was changed to application/json;odata.streaming=true for the response status
- info
  media type application/json;odata.streaming=true; version=1 was changed to application/json;odata.streaming=true for the response status
- info
  media type application/json;odata.streaming=true; version=1 was changed to application/json;odata.streaming=true for the response status
- info
  media type application/xml; version=1 was changed to application/xml for the response status
- info
  media type application/xml; version=1 was changed to application/xml for the response status
- info
  media type application/xml; version=1 was changed to application/xml for the response status
- info
  media type text/plain; version=1 was changed to text/plain for the response status
- info
  media type text/plain; version=1 was changed to text/plain for the response status
- info
  media type text/plain; version=1 was changed to text/plain for the response status

Operation history (3 revisions)

Gets a single Absence referenced by ID.

Request

Path parameters

Response 200OK

Changes

Response