Get all locations

get

/hcmRestApi/resources/11.13.18.05/locationsV2

Request

Query Parameters
  • This query parameter is used to fetch resources which are effective dated as of the specified start date. The value of this query parameter is a string having a date in yyyy-MM-dd format
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • Used as a predefined finder to search the collection.

    Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables

    • PrimaryKey Finds all the locations that match the specified primary key criteria.
      Finder Variables
      • EffectiveEndDate; string; Effective end date for the location.
      • EffectiveStartDate; string; Effective start date for the location.
      • LocationId; integer; Surrogate identifier for the location.
    • findByLocationId Finds all the locations that match the specified location identifier.
      Finder Variables
      • LocationId; integer; Surrogate identifier for the location.
      • SysEffectiveDate; object;
    • findByLocationIdAfterReload Finds all the locations that match the specified location and transaction identifiers, and is used during the edit by approver task reload.
      Finder Variables
      • LocationId; integer; Surrogate identifier for the location provided to the finder that's used during the edit by approver task reload.
      • SysEffectiveDate; object;
      • TransactionId; integer; Surrogate identifier for the location transaction provided to the finder that's used during the edit by approver task reload.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EffectiveEndDate; string
    • EffectiveStartDate; string
    • LocationDetailsId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AddressUsageType; string; Type of the address usage.
    • AddressUsageTypeMeaning; string; Meaning of the address usage.
    • Building; string; Building name of the address.
    • Country; string; Country for the location address.
    • EffectiveEndDate; string; Effective end date for the location address.
    • EffectiveStartDate; string; Effective start date for the location address.
    • FloorNumber; string; Floor number of the address.
    • Latitude; number; Distance between the equator and a location address located to its north or south, expressed in degrees and minutes.
    • LocAddressUsageId; integer; Unique identifier for the address usage type.
    • LongPostalCode; string; Long postal code for the location address. Long postal codes are used in some countries in addition to the short postal codes.
    • Longitude; number; Distance between the prime meridian and a location address located to its east or west, expressed in degrees and minutes.
    • PostalCode; string; Postal code for the location address.
    • Provider; string; Company that has validated a location address.
    • Region1; string; Primary region in which the address is located. This value may be required depending on the country specified.
    • Region2; string; Secondary region withing the primary region.
    • Region3; string; Subregion within the secondary region.
    • TimezoneCode; string; Code of the time zone.
    • TownOrCity; string; Town or city of the location address. This value may be required depending on the country specified.
    • ValidationStatusCode; string; Level of accuracy of a location address as determined by an address provider.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ActionReason; string; Reason for the action being performed on the record.
    • ActionReasonCode; string; Reason code for the action being performed on the record. Valid values are defined in the actionReasonsLOV.
    • ActiveStatus; string; Status of the location, such as active.
    • ActiveStatusMeaning; string; Meaning of the status of the location.
    • AnnualWorkingDurationUnits; string; Code of the unit of the location's standard annual working duration.
    • AnnualWorkingDurationUnitsMeaning; string; Meaning of the unit of the location's standard annual working duration.
    • BillToSiteFlag; boolean; Indicates whether the location is a bill to site. The default value is true.
    • Description; string; Description of the location.
    • DesignatedReceiverId; integer; Unique identifier for the person designated as the receiver for the location.
    • DesignatedReceiverNumber; string; Number for the person designated as the receiver for the location.
    • EffectiveEndDate; string; Effective end date of the location.
    • EffectiveStartDate; string; Effective start date of the location.
    • EmailAddress; string; Email address for the location.
    • EmployeeLocationFlag; boolean; Indicates whether the location is an employee location. The default value is true.
    • FaxAreaCode; string; Area code of the fax number for the location.
    • FaxCountryCode; string; Country code of the fax number for the location.
    • FaxExtension; string; Extension for the fax number of the location.
    • FaxNumber; string; Local fax number for the location.
    • GeoHierarchyNodeCode; string; Code of the geography tree node for the location.
    • GeoHierarchyNodeName; string; Name of the geography tree node for the location.
    • InventoryOrganizationId; integer; Unique identifier for the inventory organization.
    • InventoryOrganizationName; string; Name of the inventory organization.
    • LocationCode; string; Code that uniquely references the location within the set.
    • LocationId; integer; Surrogate identifier for the location.
    • LocationName; string; Name of the location.
    • MainPhoneAreaCode; string; Area code of the main phone number for the location.
    • MainPhoneCountryCode; string; Country code of the main phone number for the location.
    • MainPhoneExtension; string; Extension for the main phone number for the location.
    • MainPhoneNumber; string; Local main phone number for the location.
    • OfficeSiteFlag; boolean; Indicates whether the location is an office site. The default value is true.
    • OfficialLanguageCode; string; Code of the location's official language.
    • OfficialLanguageMeaning; string; Name of the location's official language.
    • OtherPhoneAreaCode; string; Area code of the other phone number for the location.
    • OtherPhoneCountryCode; string; Country code of the other phone number for the location.
    • OtherPhoneExtension; string; Extension for the other phone number of the location.
    • OtherPhoneNumber; string; Local number of the other phone number for the location.
    • ReceivingSiteFlag; boolean; Indicates whether the location is a receiving site. The default value is true.
    • SetCode; string; Code of the set to which the location belongs.
    • SetId; integer; Surrogate identifier for the set to which the location belongs.
    • SetName; string; Name of the set to which the location belongs.
    • ShipToLocationCode; string; Code for the ship to location.
    • ShipToLocationId; integer; Unique identifier for the ship to location.
    • ShipToSiteFlag; boolean; Indicates whether the location is a ship to site. The default value is true.
    • StandardAnnualWorkingDuration; number; Standard annual working duration for the location.
    • StandardWorkingFrequency; string; Code of the frequency of the location's standard working hours.
    • StandardWorkingFrequencyMeaning; string; Meaning of the frequency of the location's standard working hours.
    • StandardWorkingHours; number; Number of standard working hours for the location.
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
  • This header accepts a string value. The string is a semi-colon separated list of =. It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers.
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : locationsV2
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : locationsV2-item-response
Type: object
Show Source
Nested Schema : Addresses
Type: array
Title: Addresses
The addresses resource is a child of the locations resource. It provides all the addresses of the location including the main address as of the specified date. By default, the current date is retained.
Show Source
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Banner Override Messages
Type: array
Title: Banner Override Messages
The bannerOverrideMessages resource provides all the status information and related messages for an object.
Show Source
Nested Schema : locationLegislativeEFF
Type: array
Show Source
  • Discriminator: CategoryCode
    Discriminator: { "propertyName":"CategoryCode", "mapping":{ "HCM_LOC_LEG":"#/components/schemas/oracle_apps_hcm_locations_flex_locationlegeff_category_view_j__LocationLegCategoryHcmLocLegprivateVO-item-response" } }
Nested Schema : locationsDFF
Type: array
Show Source
Nested Schema : Locations Extensible Flexfields Container
Type: array
Title: Locations Extensible Flexfields Container
The locationEFFContainer resource is a child of the locations resource. It's a container for the locations extensible flexfields.
Show Source
Nested Schema : locationsV2-addresses-item-response
Type: object
Show Source
Nested Schema : locationsV2-attachments-item-response
Type: object
Show Source
Nested Schema : locationsV2-bannerOverrideMessages-item-response
Type: object
Show Source
Nested Schema : Discriminator: CategoryCode
Type: object
Discriminator: CategoryCode

Discriminator Values

Match One Schema
Show Source
Nested Schema : oracle_apps_hcm_locations_flex_locationlegeff_category_view_j__LocationLegCategoryHcmLocLegprivateVO-item-response
Type: object
Show Source
Nested Schema : LocationLegislativeHRX_5FCA_5FLOC_5FEER_5FRULESprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FFR_5FEXT_5FREPORTING_5FINFOprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FEEO1_5FINFORMATIONprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FLOC_5FEEO_5FVETS_5FINFprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FMWS_5FINFORMATIONprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FPA_5FPSD_5FINFORMATIONprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FREPORTING_5FINFORMATIONprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FUNEMPLOYMENT_5FREPORTINGprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeHRX_5FUS_5FVETS_5FINFORMATIONprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeORA_5FHRX_5FCA_5FPM_5FLOCprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeORA_5FHRX_5FCA_5FWC_5FLOCprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeORA_5FHRX_5FIN_5FEMPLR_5FCONT_5FINFOprivateVO
Type: array
Show Source
Nested Schema : LocationLegislativeORA_5FHRX_5FUS_5FWORK_5FTAX_5FJURDprivateVO
Type: array
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FCA_5FLOC_5FEER_5FRULESprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FFR_5FEXT_5FREPORTING_5FINFOprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FEEO1_5FINFORMATIONprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FLOC_5FEEO_5FVETS_5FINFprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FMWS_5FINFORMATIONprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FPA_5FPSD_5FINFORMATIONprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FREPORTING_5FINFORMATIONprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FUNEMPLOYMENT_5FREPORTINGprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeHRX_5FUS_5FVETS_5FINFORMATIONprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeORA_5FHRX_5FCA_5FPM_5FLOCprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeORA_5FHRX_5FCA_5FWC_5FLOCprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeORA_5FHRX_5FIN_5FEMPLR_5FCONT_5FINFOprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationLegislativeEFF-LocationLegislativeORA_5FHRX_5FUS_5FWORK_5FTAX_5FJURDprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationsDFF-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationsEFFContainer-item-response
Type: object
Show Source
Nested Schema : locationsEFF
Type: array
Show Source
  • Discriminator: CategoryCode
    Discriminator: { "propertyName":"CategoryCode", "mapping":{ "HCM_LOC":"#/components/schemas/oracle_apps_hcm_locations_flex_locationextraInfoeff_category_view_j__LocationEitCategoryHcmLocprivateVO-item-response" } }
Nested Schema : Discriminator: CategoryCode
Type: object
Discriminator: CategoryCode

Discriminator Values

Match One Schema
Show Source
Nested Schema : oracle_apps_hcm_locations_flex_locationextraInfoeff_category_view_j__LocationEitCategoryHcmLocprivateVO-item-response
Type: object
Show Source
Nested Schema : LocationExtraInfoJE_5FES_5FPRL_5FNOprivateVO
Type: array
Show Source
Nested Schema : LocationExtraInfoJE_5FES_5FPRL_5FYESprivateVO
Type: array
Show Source
Nested Schema : LocationExtraInfoJE_5FES_5FRENTED_5FLOCATIONprivateVO
Type: array
Show Source
Nested Schema : LocationExtraInfoJExESPropertyLocationprivateVO
Type: array
Show Source
Nested Schema : LocationExtraInfoORA_5FPER_5FOPERATIVE_5FLEGAL_5FEMPprivateVO
Type: array
Show Source
Nested Schema : locationsV2-locationsEFFContainer-locationsEFF-LocationExtraInfoJE_5FES_5FPRL_5FNOprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationsEFFContainer-locationsEFF-LocationExtraInfoJE_5FES_5FPRL_5FYESprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationsEFFContainer-locationsEFF-LocationExtraInfoJE_5FES_5FRENTED_5FLOCATIONprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationsEFFContainer-locationsEFF-LocationExtraInfoJExESPropertyLocationprivateVO-item-response
Type: object
Show Source
Nested Schema : locationsV2-locationsEFFContainer-locationsEFF-LocationExtraInfoORA_5FPER_5FOPERATIVE_5FLEGAL_5FEMPprivateVO-item-response
Type: object
Show Source
Back to Top

Examples

The following example shows how to retrieve all the locations by submitting a GET request on the REST resource using cURL.

curl -i -u "<username>:<password>" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -X GET "https://<host>:<port>/hcmRestApi/resources/11.13.18.05/locationsV2"

Example of Response Header

The following is an example of the response header.

Status: HTTP/1.1 200 OK
Content-Type: application/vnd.oracle.adf.resourceitem+json

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
  "items": [
    {
      "LocationId": 300100188136324,
      "LocationCode": "PL_CA",
      "LocationName": "Pleasanton",
      "EffectiveStartDate": "2018-01-01",
      "EffectiveEndDate": "4712-12-31",
      "ActionReasonCode": null,
      "ActionReason": null,
      "ActiveStatus": "A",
      "ActiveStatusMeaning": "Active",
      "SetId": 0,
      "SetCode": "COMMON",
      "SetName": "Common Set",
      "Description": "Pleasanton Office",
      "InventoryOrganizationId": 458,
      "InventoryOrganizationName": "Vision Services",
      "OfficialLanguageCode": "US",
      "OfficialLanguageMeaning": "American English",
      "EmailAddress": "example@example.com",
      "GeoHierarchyNodeCode": "DE",
      "MainPhoneCountryCode": "1",
      "MainPhoneAreaCode": "040",
      "MainPhoneNumber": "555-1212",
      "MainPhoneExtension": "555-1213",
      "FaxCountryCode": "1",
      "FaxAreaCode": "050",
      "FaxNumber": "555-9999999",
      "FaxExtension": "555-9999999",
      "OtherPhoneCountryCode": "244",
      "OtherPhoneAreaCode": "060",
      "OtherPhoneNumber": "555-2222",
      "OtherPhoneExtension": "555-2233",
      "ShipToSiteFlag": false,
      "ShipToLocationId": 3033,
      "ShipToLocationCode": "ARMY_PENTAGON_0_2452230072550",
      "ShipToLocationName": "Army Pentagon",
      "OfficeSiteFlag": true,
      "BillToSiteFlag": true,
      "ReceivingSiteFlag": true,
      "DesignatedReceiverId": 100100124777049,
      "DesignatedReceiverNumber": "GHR_LINE_MGR",
      "DesignatedReceiverName": "GHR_LINE_MGR",
      "CreatedBy": "HCM_INTEGRATION_SPEC",
      "CreationDate": "2020-05-28T17:44:47+00:00",
      "LastUpdatedBy": "HCM_INTEGRATION_SPEC",
      "LastUpdateDate": "2020-05-28T17:44:47.767+00:00",
      "links": [
          {.... 
             }
  ]
}
Back to Top