// fusionrest agent · hcm

Locations V2

locationsV2 Based on latest (2026.09)

Create, change, delete and look up Locations V2, with addresses and banner override messages. Actions include get reloaded EFF data and split location for child update.

The record key locationsV2UniqID 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/locationsV2
Operations
GET (list)GET (one)POST (create)PATCH (update)DELETE6 actions
Record key
locationsV2UniqID
Required on create
EffectiveEndDateEffectiveStartDateLocationCodeLocationNameSetCodeSetId
At a glance
58 fields2 finders8 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/locationsV2?fields=ActionId,ActionReason,ActionReasonCode,ActionReasonId,ActiveStatus&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "ActionId": 0,
      "ActionReason": "<string, max 80>",
      "ActionReasonCode": "<string, max 30>",
      "ActionReasonId": 0,
      "ActiveStatus": "A"
    }
  ],
  "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 58

AttributeTypeUse
ActionIdnumberOptional on createUpdatable
ActionReasontext · max 80Read-onlySearchable
ActionReasonCodetext · max 30Optional on createUpdatableSearchable
ActionReasonIdnumberOptional on createUpdatable
ActiveStatustext · max 30 · default AOptional on createUpdatableSearchable
ActiveStatusMeaningtext · max 80Read-onlySearchable
AnnualWorkingDurationUnitstext · max 10Optional on createUpdatableSearchable
AnnualWorkingDurationUnitsMeaningtext · max 80Read-onlySearchable
BillToSiteFlagyes/no · max 30 · default trueOptional on createUpdatableSearchable
CreatedBytext · max 64Read-only
CreationDatedate-timeRead-only
DeliverToSiteFlagyes/no · max 1 · default trueOptional on createUpdatableSearchable
Descriptiontext · max 240Optional on createUpdatableSearchable
DesignatedReceiverIdnumberOptional on createUpdatableSearchable
DesignatedReceiverNametext · max 240Read-only
DesignatedReceiverNumbertext · max 30Optional on createUpdatableSearchable
EffectiveEndDatedateRequired on createUpdatableSearchable
EffectiveStartDatedateRequired on createUpdatableSearchable
EmailAddresstext · max 240Optional on createUpdatableSearchable
EmployeeLocationFlagyes/no · max 1 · default trueOptional on createUpdatableSearchable
FaxAreaCodetext · max 60Optional on createUpdatableSearchable
FaxCountryCodetext · max 30Optional on createUpdatableSearchable
FaxExtensiontext · max 60Optional on createUpdatableSearchable
FaxNumbertext · max 60Optional on createUpdatableSearchable
GeoHierarchyNodeCodetext · max 100Optional on createUpdatableSearchable
GeoHierarchyNodeNametext · max 80Read-onlySearchable
InventoryOrganizationIdnumberOptional on createUpdatableSearchable
InventoryOrganizationNametext · max 240Optional on createUpdatableSearchable
LastUpdateDatedate-timeRead-only
LastUpdatedBytext · max 64Read-only
LocationCodetext · max 120Required on createUpdatableSearchable
LocationIdnumberOptional on createSearchable
LocationNametext · max 60Required on createUpdatableSearchable
MainPhoneAreaCodetext · max 60Optional on createUpdatableSearchable
MainPhoneCountryCodetext · max 30Optional on createUpdatableSearchable
MainPhoneExtensiontext · max 60Optional on createUpdatableSearchable
MainPhoneNumbertext · max 60Optional on createUpdatableSearchable
OfficeSiteFlagyes/no · max 30 · default trueOptional on createUpdatableSearchable
OfficialLanguageCodetext · max 30Optional on createUpdatableSearchable
OfficialLanguageMeaningtext · max 80Read-onlySearchable
OtherPhoneAreaCodetext · max 60Optional on createUpdatableSearchable
OtherPhoneCountryCodetext · max 30Optional on createUpdatableSearchable
OtherPhoneExtensiontext · max 60Optional on createUpdatableSearchable
OtherPhoneNumbertext · max 60Optional on createUpdatableSearchable
ReceivableMaterialstext · max 2000Optional on createUpdatableSearchable
ReceivableMaterialsMeaningtext · max 80Read-onlySearchable
ReceivingSiteFlagyes/no · max 30 · default trueOptional on createUpdatableSearchable
SetCodetext · max 30Required on createSearchable
SetIdnumberRequired on createSearchable
SetNametext · max 80Read-onlySearchable
ShipToLocationCodetext · max 120Optional on createUpdatableSearchable
ShipToLocationIdnumberOptional on createUpdatableSearchable
ShipToLocationNametext · max 60Read-only
ShipToSiteFlagyes/no · max 30 · default trueOptional on createUpdatableSearchable
StandardAnnualWorkingDurationnumberOptional on createUpdatableSearchable
StandardWorkingFrequencytext · max 30Optional on createUpdatableSearchable
StandardWorkingFrequencyMeaningtext · max 80Read-onlySearchable
StandardWorkingHoursnumberOptional 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 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 8

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

Actions 6

Actions use Content-Type: application/vnd.oracle.adf.action+json. A path with a {key} runs on one record.

Use in AI Agent Studio

More in For Builders.

Pitfalls