// fusionrest agent · hcm

Employees

emps Based on latest (2026.09)

Create, change and look up Employees, with assignments, direct reports and person extra information.

The record key empsUniqID is a generated hash. Take it from the record's links (rel self) in a GET response; never build it yourself.

Oracle documents an Effective-Of header and an effectiveDate parameter for this resource, used for date-effective reads and changes.

/hcmRestApi/resources/11.13.18.05/emps
Operations
GET (list)GET (one)POST (create)PATCH (update)
Record key
empsUniqID
Required on create
CitizenshipLegislationCodeCitizenshipStatusCountryEffectiveStartDateHireDateHomeFaxNumberHomePhoneNumberLastNameLegalEntityIdNationalIdNationalIdCountryNationalIdTypeWorkEmailWorkFaxNumberWorkMobilePhoneNumberWorkPhoneNumber
At a glance
80 fields2 finders11 children
Extra parameters
?effectiveDate=Effective-Of:
I want to…List the latest 25Count recordsGet one recordCreate oneUpdate one

Try it

Response fields ·
Filters (q)

Only attributes Oracle marks as searchable are offered.

Finder
Include children (expand)
Paging and options
limit
Endpoint and headers
GET /hcmRestApi/resources/11.13.18.05/emps?fields=AddressLine1,AddressLine2,AddressLine3,CitizenshipId,CitizenshipLegislationCode&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "AddressLine1": "<string, max 240>",
      "AddressLine2": "<string, max 240>",
      "AddressLine3": "<string, max 240>",
      "CitizenshipId": 0,
      "CitizenshipLegislationCode": "<string, max 30>"
    }
  ],
  "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 80

AttributeTypeUse
AddressLine1text · max 240Optional on createUpdatableSearchable
AddressLine2text · max 240Optional on createUpdatableSearchable
AddressLine3text · max 240Optional on createUpdatableSearchable
CitizenshipIdnumberOptional on createSearchable
CitizenshipLegislationCodetext · max 30Required on createSearchable
CitizenshipStatustext · max 30Required on createUpdatableSearchable
CitizenshipToDatedateOptional on createUpdatableSearchable
Citytext · max 60Optional on createUpdatableSearchable
CorrespondenceLanguagetext · max 30Optional on createUpdatableSearchable
Countrytext · max 60Required on createSearchable
CreationDatedate-timeRead-onlySearchable
DateOfBirthdateOptional on createUpdatableSearchable
DisplayNametext · max 240Optional on createUpdatableSearchable
DriversLicenseExpirationDatedateOptional on createUpdatableSearchable
DriversLicenseIdnumberOptional on createSearchable
DriversLicenseIssuingCountrytext · max 30Optional on createUpdatableSearchable
EffectiveStartDatedateRequired on createUpdatableSearchable
Ethnicitytext · max 30Optional on createUpdatableSearchable
FirstNametext · max 150Optional on createUpdatableSearchable
Gendertext · max 30Optional on createUpdatableSearchable
HireDatedateRequired on createUpdatableSearchable
HomeFaxAreaCodetext · max 30Optional on createUpdatableSearchable
HomeFaxCountryCodetext · max 30Optional on createUpdatableSearchable
HomeFaxExtensiontext · max 60Optional on createUpdatableSearchable
HomeFaxLegislationCodetext · max 4Optional on createUpdatableSearchable
HomeFaxNumbertext · max 60Required on createUpdatableSearchable
HomePhoneAreaCodetext · max 30Optional on createUpdatableSearchable
HomePhoneCountryCodetext · max 30Optional on createUpdatableSearchable
HomePhoneExtensiontext · max 60Optional on createUpdatableSearchable
HomePhoneLegislationCodetext · max 4Optional on createUpdatableSearchable
HomePhoneNumbertext · max 60Required on createUpdatableSearchable
Honorstext · max 80Optional on createUpdatableSearchable
LastNametext · max 150Required on createUpdatableSearchable
LastUpdateDatedate-timeRead-onlySearchable
LegalEntityIdnumberRequired on createUpdatable
LicenseNumbertext · max 150Optional on createUpdatableSearchable
MaritalStatustext · max 30Optional on createUpdatableSearchable
MiddleNametext · max 80Optional on createUpdatableSearchable
MilitaryVetStatustext · max 30 · default NOptional on createUpdatableSearchable
NameSuffixtext · max 80Optional on createUpdatableSearchable
NationalIdtext · max 30Required on createUpdatableSearchable
NationalIdCountrytext · max 30Required on createSearchable
NationalIdExpirationDatedateOptional on createUpdatableSearchable
NationalIdPlaceOfIssuetext · max 30Optional on createUpdatableSearchable
NationalIdTypetext · max 30Required on createUpdatableSearchable
PassportExpirationDatedateOptional on createUpdatableSearchable
PassportIdnumberOptional on createSearchable
PassportIssueDatedateOptional on createUpdatableSearchable
PassportIssuingCountrytext · max 30Optional on createUpdatableSearchable
PassportNumbertext · max 30Optional on createUpdatableSearchable
PersonIdnumberOptional on createSearchable
PersonNumbertext · max 30Optional on createUpdatableSearchable
PostalCodetext · max 30Optional on createUpdatableSearchable
PreferredNametext · max 80Optional on createUpdatableSearchable
PreviousLastNametext · max 150Optional on createUpdatableSearchable
ProjectedTerminationDatedateOptional on createUpdatableSearchable
Regiontext · max 120Optional on createUpdatableSearchable
Region2text · max 120Optional on createUpdatableSearchable
Religiontext · max 30Optional on createUpdatableSearchable
ReligionIdnumberOptional on createSearchable
Salutationtext · max 30Optional on createUpdatableSearchable
TerminationDatedateRead-onlySearchable
UserNametext · max 100Optional on createUpdatableSearchable
WorkEmailtext · max 240Required on createUpdatableSearchable
WorkFaxAreaCodetext · max 30Optional on createUpdatableSearchable
WorkFaxCountryCodetext · max 30Optional on createUpdatableSearchable
WorkFaxExtensiontext · max 60Optional on createUpdatableSearchable
WorkFaxLegislationCodetext · max 4Optional on createUpdatableSearchable
WorkFaxNumbertext · max 60Required on createUpdatableSearchable
WorkMobilePhoneAreaCodetext · max 30Optional on createUpdatableSearchable
WorkMobilePhoneCountryCodetext · max 30Optional on createUpdatableSearchable
WorkMobilePhoneExtensiontext · max 60Optional on createUpdatableSearchable
WorkMobilePhoneLegislationCodetext · max 4Optional on createUpdatableSearchable
WorkMobilePhoneNumbertext · max 60Required on createUpdatableSearchable
WorkPhoneAreaCodetext · max 30Optional on createUpdatableSearchable
WorkPhoneCountryCodetext · max 30Optional on createUpdatableSearchable
WorkPhoneExtensiontext · max 60Optional on createUpdatableSearchable
WorkPhoneLegislationCodetext · max 4Optional on createUpdatableSearchable
WorkPhoneNumbertext · max 60Required on createUpdatableSearchable
WorkerTypetext · max 30Read-onlySearchable

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 2

Predefined searches: ?finder=Name;variable=value,variable2=value2. Pick one in Try it to build the call.

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/emps/{empsUniqID}/child/<name>. Add them to a GET with expand.

Use in AI Agent Studio

More in For Builders.

Pitfalls