// fusionrest agent · hcm

Locations

locations Based on latest (2026.09)

Look up Locations. Read-only.

The record key locationsUniqID 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/locations
Operations
GET (list)GET (one)
Record key
locationsUniqID
Required on create
no create on this resource
At a glance
40 fields2 finders1 children
Extra parameters
?effectiveDate=Effective-Of:
I want to…List the latest 25Count recordsGet one record

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/locations?fields=ActiveStatus,AddressLine1,AddressLine2,AddressLine3,AddressLine4&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "ActiveStatus": "A",
      "AddressLine1": "<string, max 240>",
      "AddressLine2": "<string, max 240>",
      "AddressLine3": "<string, max 240>",
      "AddressLine4": "<string, max 240>"
    }
  ],
  "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 40

AttributeTypeUse
ActiveStatustext · max 30 · default ASearchable
AddressLine1text · max 240Searchable
AddressLine2text · max 240Searchable
AddressLine3text · max 240Searchable
AddressLine4text · max 240Searchable
AnnualWorkingDurationUnitstext · max 10Searchable
BillToSiteFlagyes/no · max 30 · default trueSearchable
Countrytext · max 60Searchable
CreationDatedate-timeRead-only
DeliverToSiteFlagyes/no · max 1 · default trueSearchable
Descriptiontext · max 240
EffectiveEndDatedateSearchable
EffectiveStartDatedateSearchable
EmailAddresstext · max 240
EmployeeLocationFlagyes/no · max 1 · default trueSearchable
LastUpdateDatedate-timeRead-onlySearchable
LatitudenumberSearchable
LocationCodetext · max 120Searchable
LocationIdnumberSearchable
LocationNametext · max 60Searchable
LongitudenumberSearchable
MainAddressIdnumber · default 1
OfficeSiteFlagyes/no · max 30 · default trueSearchable
PostalCodetext · max 30Searchable
Providertext · max 150Searchable
ReceivableMaterialstext · max 2000Searchable
ReceivingSiteFlagyes/no · max 30 · default trueSearchable
Region1text · max 120Searchable
Region2text · max 120Searchable
Region3text · max 120Searchable
SetIdnumberSearchable
ShipToSiteFlagyes/no · max 30 · default trueSearchable
StandardAnnualWorkingDurationnumberSearchable
StandardWorkingFrequencytext · max 30Searchable
StandardWorkingHoursnumberSearchable
TelephoneNumber1text · max 240
TelephoneNumber2text · max 240
TelephoneNumber3text · max 240
TownOrCitytext · max 60Searchable
ValidationStatusCodetext · max 120Searchable

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 1

Child resources sit under one record: /hcmRestApi/resources/11.13.18.05/locations/{locationsUniqID}/child/<name>. Add them to a GET with expand.

Use in AI Agent Studio

More in For Builders.

Pitfalls