Absences
absences Based on latest (2026.09)
Create, change, delete and look up Absences, with absence entitlement unique plans, absence entitlements and absence entry certifications. Actions include absence daily details breakdown and check active scheduling profile.
The record key absencesUniqID is a generated hash. Take it from the record's links (rel self) in a GET response; never build it yourself.
- Operations
- GET (list)GET (one)POST (create)PATCH (update)DELETE13 actions
- Record key
absencesUniqID- Required on create
absenceTypeIdlegalEntityIdpersonId- At a glance
- 86 fields9 finders11 children
Try it
Only attributes Oracle marks as searchable are offered.
GET /hcmRestApi/resources/11.13.18.05/absences?fields=ApprovalDatetime,LastApprovalDatetime,ObjectVersionNumber,UnpaidBreakDuration,absenceCaseId&limit=25&onlyData=true
{
"items": [
{
"ApprovalDatetime": "2026-01-31T09:00:00+00:00",
"LastApprovalDatetime": "2026-01-31T09:00:00+00:00",
"ObjectVersionNumber": 0,
"UnpaidBreakDuration": 0,
"absenceCaseId": 0
}
],
"count": 25,
"hasMore": true,
"limit": 25,
"offset": 0
}Shapes and placeholders, not real data. Replace https://<your-pod> and the login with your own: this site never sees them. Based on Oracle's latest (2026.09) REST specification.
Fields 86
| Attribute | Type | Use |
|---|---|---|
ApprovalDatetime | date-time | Read-onlySearchable |
LastApprovalDatetime | date-time | Optional on createUpdatableSearchable |
ObjectVersionNumber | number | Read-onlySearchable |
UnpaidBreakDuration | number | Optional on createUpdatableSearchable |
absenceCaseId | number | Optional on createUpdatableSearchable |
absenceDispStatus | text | Optional on createUpdatableSearchable |
absenceDispStatusMeaning | text · max 255 | Read-only |
absenceEntryBasicFlag | yes/no · max 30 · default false | Optional on createUpdatableSearchable |
absencePatternCd | text · max 20 | Optional on createUpdatableSearchable |
absenceReason | text | Optional on createUpdatableSearchable |
absenceStatusCd | text · max 30 · default 'SUBMITTED' | Optional on createUpdatableSearchable |
absenceType | text | Optional on createSearchable |
absenceTypeId | number | Required on createSearchable |
absenceTypeReasonId | number | Optional on createUpdatableSearchable |
absenceUpdatableFlag | yes/no · max 255 | Read-only |
agreementId | number | Optional on createUpdatableSearchable |
agreementName | text | Optional on createUpdatableSearchable |
allowAssignmentSelectionFlag | yes/no | Read-only |
approvalStatusCd | text · max 30 | Optional on createUpdatableSearchable |
assignmentId | number | Optional on createUpdatableSearchable |
assignmentName | text · max 80 | Read-onlySearchable |
assignmentNumber | text · max 30 | Read-onlySearchable |
authStatusUpdateDate | date | Optional on createUpdatableSearchable |
bandDtlId | number | Optional on createUpdatableSearchable |
blockedLeaveCandidate | text · max 30 | Optional on createUpdatableSearchable |
certificationAuthFlag | yes/no · max 30 | Optional on createUpdatableSearchable |
childEventTypeCd | text · max 30 | Optional on createUpdatableSearchable |
comments | text · max 2000 | Optional on createUpdatableSearchable |
conditionStartDate | date | Optional on createUpdatableSearchable |
confirmedDate | date | Optional on createUpdatableSearchable |
consumedByAgreement | text · max 30 | Optional on createUpdatableSearchable |
createdBy | text · max 64 | Read-onlySearchable |
creationDate | date-time | Read-onlySearchable |
dataSecurityPersonId | number | Read-onlySearchable |
diseaseCode | text · max 250 | Optional on createUpdatableSearchable |
duration | number | Optional on createUpdatableSearchable |
effectiveEndDate | date | Read-onlySearchable |
effectiveStartDate | date | Read-onlySearchable |
employeeShiftFlag | yes/no · max 20 | Optional on createUpdatableSearchable |
employer | text | Optional on createSearchable |
endDate | date | Optional on createUpdatableSearchable |
endDateDuration | number | Optional on createUpdatableSearchable |
endDateDurationPreferenceCode | text · max 30 | Optional on createUpdatableSearchable |
endDateDurationPreferenceMeaning | text · max 80 | Read-onlySearchable |
endDateTime | date-time | Optional on createUpdatableSearchable |
endTime | text · max 30 | Optional on createUpdatableSearchable |
establishmentDate | date | Optional on createUpdatableSearchable |
formattedDuration | text · max 255 | Read-only |
frequency | text · max 30 | Optional on createUpdatableSearchable |
ignoreWarningFlag | yes/no · max 80 | Optional on createUpdatable |
initialReportById | number | Optional on createUpdatableSearchable |
initialTimelyNotifyFlag | yes/no · max 30 | Optional on createUpdatableSearchable |
lastUpdateDate | date-time | Read-onlySearchable |
lastUpdateLogin | text · max 32 | Read-onlySearchable |
lastUpdatedBy | text · max 64 | Read-onlySearchable |
lateNotifyFlag | yes/no · max 30 | Optional on createUpdatableSearchable |
legalEntityId | number | Required on createUpdatableSearchable |
legislationCode | text · max 30 | Optional on createUpdatableSearchable |
legislativeDataGroupId | number | Optional on createUpdatableSearchable |
notificationDate | date | Optional on createUpdatableSearchable |
objectVersionNumber | number | Optional on createUpdatableSearchable |
openEndedFlag | yes/no · max 1 · default false | Optional on createUpdatableSearchable |
overridden | text · max 10 · default N | Optional on createUpdatableSearchable |
paymentDetail | text | Optional on createUpdatableSearchable |
periodOfIncapToWorkFlag | yes/no · max 30 | Optional on createUpdatableSearchable |
periodOfServiceId | number | Optional on createUpdatableSearchable |
personAbsenceEntryId | number | Optional on createSearchable |
personId | number | Required on createSearchable |
personNumber | text | Optional on createSearchable |
plannedEndDate | date | Optional on createUpdatableSearchable |
processingStatus | text · max 30 | Optional on createUpdatableSearchable |
projectId | number | Optional on createUpdatableSearchable |
singleDayFlag | yes/no · max 1 · default false | Optional on createUpdatableSearchable |
source | text · max 10 · default 'REST' | Optional on createUpdatableSearchable |
splCondition | text · max 1000 | Optional on createUpdatableSearchable |
startDate | date | Optional on createUpdatableSearchable |
startDateDuration | number | Optional on createUpdatableSearchable |
startDateDurationPreferenceCode | text · max 30 | Optional on createUpdatableSearchable |
startDateDurationPreferenceMeaning | text · max 80 | Read-onlySearchable |
startDateTime | date-time | Optional on createUpdatableSearchable |
startTime | text · max 30 | Optional on createUpdatableSearchable |
submittedDate | date | Optional on createUpdatableSearchable |
timelinessOverrideDate | date | Optional on createUpdatableSearchable |
unitOfMeasure | text · max 30 | Optional on createUpdatableSearchable |
unitOfMeasureMeaning | text · max 80 | Read-only |
userMode | text · max 10 · default EMP | Optional on createUpdatableSearchable |
Names, types, labels and flags from Oracle's REST specification (latest (2026.09)). Flexfield and custom attributes vary by pod: check /describe for yours.
Finders 9
Predefined searches: ?finder=Name;variable=value,variable2=value2. Pick one in Try it to build the call.
findAbsenceUsingAllAbsParameters·absenceTypeIdendDatepersonAbsenceEntryIdpersonIdstartDatefindByAbsDate·startDatefindByAbsStartAndEndDate·endDatestartDatefindByAbsenceEntryId·personAbsenceEntryIdfindByAbsenceLinkages·absencePatternCdabsenceTypeIdpersonAbsenceEntryIdpersonIdstartDatefindByAbsenceTypeId·absenceTypeIdfindByPersonAbsenceTypeIdAndAbsDate·absenceTypeIdendDatepersonIdstartDatefindByPersonAndAbsenceTypeId·absenceTypeIdpersonIdfindByPersonId·personId
Check a payload
Checked in your browser only; nothing you paste is sent anywhere. Checks names and flags, not values.
Children 11
Child resources sit under one record: /hcmRestApi/resources/11.13.18.05/absences/{absencesUniqID}/child/<name>. Add them to a GET with expand.
absenceAttachmentsGET · POST · PATCH · DELETE Absence Attachments · 33 fields · 1 findersAsyncTrackerIdAttachedDocumentIdCategoryNameContentRepositoryFileSharedCreatedByCreatedByUserNameCreationDateDatatypeCodeDatatypeCodeMeaningDescriptionDmDocumentIdDmFolderPathDmVersionNumberDownloadInfoErrorStatusCodeErrorStatusMessageExpirationDateFileContentsFileNameFileUrlFileWebImageLastUpdateDateLastUpdatedByLastUpdatedByUserNamePostProcessingActionTitleUploadedFileContentTypeUploadedFileLengthUploadedFileNameUploadedTextUriUrlUserNameabsenceEntitlementUniquePlansGET Absence Entitlement Unique Plans · 10 fieldsAbsenceTypeIdDisableEntOverrideFlagEffectiveEndDateEffectiveStartDateEndDateLanguageNamePersonAbsenceEntryIdPlanIdStartDateabsenceEntitlementsGET Absence Entitlements · 36 fieldsCreatedByCreationDateLastUpdateDateLastUpdatedByabsenceCaseIdabsencePlanIdabsencePlanNameabsencePlanUOMMeaningactivityCdactivityCdMeaningactivityEndCalendarDateactivityEndDateactivityStartCalendarDateactivityStartDateassignmentIdassignmentNameassignmentNumbercalculationDatechangeReasonCdchangeReasonCdMeaningentitlementIdentitlementMethodCdentitlementMethodCdMeaningformattedUnitspayFactorpersonAbsenceEntryIdpersonAbsenceTypeEntryIdpersonIdplanPeriodStartCalendarDateplanPeriodStartDateremainingsourcesourceCdMeaningunitOfMeasureunitsusedabsenceEntitlementDetailsGET Absence Entitlement Details · 13 fieldsCreatedByCreationDateLastUpdateDateLastUpdatedByabsencePlanUOMMeaningendDateentitlementDetailIdentitlementIdformattedUnitspayFactorstartDateunitOfMeasureunitsabsenceEntryCertificationsGET · POST · PATCH · DELETE Absence Certifications · 52 fieldsAbsenceAggregationIdAbsenceCertificationIdAcceptedByAcceptedDateAcceptedFlagCaseIdCertificationCreationDateCertificationCreationModeCertificationCreationModeMeaningClassificationCodeClassificationCodeMeaningCommentsCompleteFlagConfirmActionFlagConfirmationDateConfirmationReasonCodeConfirmationReasonMeaningCreatedByCreationDateDescriptionEvidenceSourceLastUpdateDateLastUpdateLoginLastUpdateTypeLastUpdateTypeMeaningLastUpdatedByLateReasonNamePersonAbsenceEntryIdPersonCertificationIdPersonIdReceivedDateReceivedFlagReceivedLateFlagRequiredByDateReviseDateActionFlagRevisedPayEndDateRevisedPayPercentageRevisedPayStartDateStatusStatusMeaningTargetPlanAllFlagTargetPlanIdTargetPlanNameUpdateDueDateActionFlagUpdateExpirationDateActionFlagValidUptoDateVoidActionFlagVoidFlagVoidReasonCodeVoidReasonMeaningVoidedDatecertificationAttachmentsGET · POST · PATCH · DELETE Absence Certification Attachments · 33 fields · 1 findersAsyncTrackerIdAttachedDocumentIdCategoryNameContentRepositoryFileSharedCreatedByCreatedByUserNameCreationDateDatatypeCodeDatatypeCodeMeaningDescriptionDmDocumentIdDmFolderPathDmVersionNumberDownloadInfoErrorStatusCodeErrorStatusMessageExpirationDateFileContentsFileNameFileUrlFileWebImageLastUpdateDateLastUpdatedByLastUpdatedByUserNamePostProcessingActionTitleUploadedFileContentTypeUploadedFileLengthUploadedFileNameUploadedTextUriUrlUserNameabsenceEntryDetailsGET · POST · PATCH · DELETE Absence Entry Details · 22 fieldsAbsenceDateAbsenceDatetimeAbsenceEndDatetimeAssignmentIdAssignmentNumberCreatedByCreationDateDayPreferenceCodeDayPreferenceMeaningDurationDurationPreferenceCodeDurationPreferenceMeaningEndTimeFormattedDurationLastUpdateDateLastUpdatedByPersonAbsenceEntryDetailIdPersonAbsenceEntryIdRowSequenceSourceStartTimeUnpaidBreakDurationabsenceMaternityGET · POST · PATCH Absence Maternity Details · 22 fieldsactualChildBirthDateactualDurationactualReturnDateactualStartDatecreatedBycreationDateexpectedDateOfChildBirthexpectedEndDateexpectedWeekOfChildBirthformattedActualDurationformattedLeaveDurationintendToWorkFlaglastUpdateDatelastUpdateLoginlastUpdatedByleaveDurationmatchingDateopenEndedFlagpersonAbsenceEntryIdpersonAbsenceMaternityIdplannedReturnDateplannedStartDateabsenceRecordingDFFGET · POST · PATCH Absence Descriptive Flexfields · 3 fieldsPerAbsenceEntryId__FLEX_Context__FLEX_Context_DisplayValueabsenceRecordingsDDFGET · POST · PATCH Absence Developer FlexfieldsFields depend on your pod's flexfield setup (check
/describe).linkedAbsencesGET · POST · PATCH · DELETE Linked Absences · 12 fieldsAbsenceEndDateAbsenceStartDateCreatedByCreationDateLastUpdateDateLastUpdateLoginLastUpdatedByLinkageReasonLinkageReasonIdLinkedPersonAbsenceEntryIdPersonAbsenceEntryIdPersonAbsenceTypeLinkageId
Actions 13
POST …/action/absenceDailyDetailsBreakdown·offsetlimitsortuserContextparametersPOST …/action/checkActiveSchedulingProfile·userModepersonIdtypeIdassignmentIdstartDatePOST …/action/downloadStackTrace·personAbsenceEntryIdPOST …/action/findByAdvancedSearchQuery·offsetquerylimitsearchFieldsfilterssortuserContextdisplayFieldsautocompleteQueryPOST …/action/findByAdvancedSearchQueryForCases·offsetquerylimitsearchFieldsfilterssortuserContextdisplayFieldsautocompleteQueryPOST …/action/getAbsenceTypeBalance·personIdtypeIdassignmentIduserContexteffectiveDatePOST …/action/getUserAccessDetails·userModepersonIdassignmentIdflowNameeffectiveDatePOST …/action/loadProjectedBalance·entryentryDetailsPOST …/action/overridePaymentPercentageEntitlement·pmtPercentreasonendDateperAbsenceEntryIdplanIdplanActivitystartDatePOST …/action/planUse·entryentryDetailsPOST …/action/reprocessAbsencesAndRunPostApprovalProcess·personIdPOST …/{absencesUniqID}/action/restrictAbsenceEdit·userContextPOST …/{absencesUniqID}/child/absenceEntryCertifications/action/performCertificateAction·certificationActionMappersonCertificationIdaction
Actions use Content-Type: application/vnd.oracle.adf.action+json. A path with a {key} runs on one record.
Use in AI Agent Studio
- Point a Business Object or REST tool at
/hcmRestApi/resources/11.13.18.05/absencesand ask only for the fields the agent needs withfields=. Big responses cost tokens and slow the agent. - Prefer a finder such as
findAbsenceUsingAllAbsParametersfor the agent's main search: its variables become clean tool parameters. - Narrow with
q=on searchable fields and a smalllimit; for a count usetotalResults=true&limit=1. - Call once and pass the result on to later steps rather than calling the same endpoint again.
- This resource can change data. Put a human approval step before any create, update, delete or action call.
More in For Builders.
Pitfalls
- Attribute names are case-sensitive in
q,fieldsand bodies:LastApprovalDatetime, notlastapprovaldatetime. - 19 fields are read-only: sending them in POST or PATCH fails or is ignored. The builder leaves them out.
onlyData=trueremoveslinks, and this resource's key only comes fromlinks. Leave it off when you need the key.- Send dates as
YYYY-MM-DD; date-time fields take ISO 8601 with a time zone. - A list returns 25 rows unless you set
limit; readhasMoreand moveoffsetto page through. - Text fields have maximum lengths (shown in the field table). Longer values are rejected.