// fusionrest agent · hcm

Positions

positions Based on latest (2026.09)

Look up Positions, with extra information, legislative extra information and valid grades. Read-only.

The record key positionsUniqID 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/positions
Operations
GET (list)GET (one)
Record key
positionsUniqID
Required on create
no create on this resource
At a glance
34 fields2 finders4 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/positions?fields=ActiveStatus,BudgetAmount,BudgetAmountCurrency,BudgetedPositionFlag,BusinessUnitId&limit=25&onlyData=true
Response shape (placeholders)
{
  "items": [
    {
      "ActiveStatus": "A",
      "BudgetAmount": 0,
      "BudgetAmountCurrency": "<string, max 20>",
      "BudgetedPositionFlag": true,
      "BusinessUnitId": 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 34

AttributeTypeUse
ActiveStatustext · max 30 · default ASearchable
BudgetAmountnumberSearchable
BudgetAmountCurrencytext · max 20Searchable
BudgetedPositionFlagyes/no · max 1 · default trueSearchable
BusinessUnitIdnumberSearchable
CalculateFTEtext · max 1 · default NSearchable
CostCentertext · max 30Searchable
CreationDatedate-timeRead-onlySearchable
DelegatePositionIdnumberSearchable
DepartmentIdnumberSearchable
EffectiveEndDatedateSearchable
EffectiveStartDatedateSearchable
EntryGradeIdnumberSearchable
EntryStepIdnumberSearchable
FTEnumber · default 1Searchable
FullPartTimetext · max 30 · default FULL_TIMESearchable
FundedByExistingPositionFlagyes/no · max 1 · default falseSearchable
GradeLadderIdnumberSearchable
HeadCountnumber · default 1Searchable
HiringStatustext · max 30 · default PROPOSEDSearchable
JobIdnumberSearchable
LastUpdateDatedate-timeRead-onlySearchable
LocationIdnumberSearchable
Nametext · max 240Searchable
OverlapAllowedFlagyes/no · max 30 · default falseSearchable
PositionCodetext · max 30Searchable
PositionIdnumberSearchable
PositionTypetext · max 30 · default SINGLESearchable
ProbationPeriodnumberSearchable
RegularTemporarytext · max 30 · default RSearchable
SeasonalEndDatedateSearchable
SeasonalFlagyes/no · max 30 · default falseSearchable
SeasonalStartDatedateSearchable
SecurityClearancetext · max 30Searchable

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 4

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

Use in AI Agent Studio

More in For Builders.

Pitfalls