Get a salary for a worker's assignment
get
/hcmRestApi/resources/11.13.18.05/salaries/{SalaryId}
Request
Path Parameters
-
SalaryId(required): integer(int64)
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
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).
-
fields: string
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 -
links: string
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 -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context: string
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".
-
REST-Framework-Version: string
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 TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
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".
-
REST-Framework-Version:
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.
Root Schema : salaries-item-response
Type:
Show Source
object-
ActionCode: string
Title:
Action CodeRead Only:trueMaximum Length:30Code of the action. -
ActionId: integer
(int64)
Title:
ActionUnique identifier of the action. -
ActionName: string
Title:
ActionRead Only:trueMaximum Length:80Action being done on this assignment, such as, Hire, Add Pending Worker, Manager Change and so on. Valid values are defined in the actionsLOV. -
ActionOccurrenceId: integer
(int64)
Unique identifier of the action occurrence.
-
ActionReason: string
Title:
Action ReasonRead Only:trueMaximum Length:80Reason for the action being done on the record. Valid values are defined in the actionReasonsLOV. -
ActionReasonCode: string
Title:
Action Reason CodeRead Only:trueMaximum Length:30Code of the action reason. -
ActionReasonId: integer
(int64)
Title:
Action ReasonUnique identifier of the action reason. -
AdjustedAnnualFtSalary: number
Annual value of the worker's salary, when working full time per adjusted full-time equivalent.
-
AdjustedAnnualSalary: number
Annual value of the worker's salary, when working per adjusted full-time equivalent.
-
AdjustedFTEUsage: string
Title:
Adjusted FTEMaximum Length:30Indicates that adjusted FTE is used. -
AdjustedFTEValue: number
Factor that represents the proportion of adjusted full-time hours a person works.
-
AdjustmentAmount: number
Title:
Adjustment AmountCalculated adjustment amount based on the previous salary. -
AdjustmentPercentage: number
Title:
Adjustment PercentageCalculated adjustment percentage based on the previous salary . -
AmountDecimalPrecision: number
Read Only:
trueDecimal precision of the salary amount, configured in salary basis. -
AmountRoundingCode: string
Read Only:
trueMaximum Length:30Code for the salary amount rounding rule. -
AnnualFullTimeSalary: number
Title:
Annualized Full-Time SalaryAnnual value of the worker's salary, if working full time. -
AnnualRoundingCode: string
Read Only:
trueMaximum Length:30Code for the annualized salary amount rounding rule. -
AnnualSalary: number
Title:
Annual SalaryAnnual value of the worker's salary. -
AssignmentId: integer
(int64)
Unique identifier for the assignment.
-
AssignmentNumber: string
Read Only:
trueMaximum Length:50Assignment number for the given assignment. -
AssignmentType: string
Maximum Length:
30Type of assignment, such as an employee, contingent worker, nonworker, or pending worker. -
BusinessTitle: string
Read Only:
trueMaximum Length:80Business title for the given assignment. -
Code: string
Read Only:
trueMaximum Length:80Code for the salary basis. -
CompaRatio: number
Title:
Compa-RatioSalary as a percentage of the grade range midpoint. Salary at the midpoint is 100. -
ComponentUsage: string
Read Only:
trueMaximum Length:30Property used to specify whether the incremental components type is SELECTED_COMPONENTS or USER_DECIDES_USAGE. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64Identifies the user who created the row. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueIdentifies the date and time that the row was created. -
CurrencyCode: string
Title:
CurrencyMaximum Length:30Currency code that the salary amount is stored in, such as USD. -
DateFrom: string
(date)
Title:
Start DateStart date of the salary. -
DateTo: string
(date)
Title:
End DateEnd date of the salary. -
DisplayName: string
Title:
Salary BasisRead Only:trueMaximum Length:80Unique name for the set of details linked to a worker's base pay. These details include the payroll characteristics used to pay base earnings, the duration of the quoted base pay, and the factor used to annualize base pay. The details also include any components used to connect base pay adjustments to different reasons and any associated grade rate for salary validation. -
FrequencyName: string
Title:
FrequencyRead Only:trueFrequency of the salary basis, such as Annually, Monthly, Weekly, or Hourly. -
FTEValue: number
Title:
FTEFactor that represents the proportion of full-time hours a person works. -
GeographyName: string
Title:
Compensation ZoneRead Only:trueMaximum Length:255Geographical zone used in compensation to calculate salary ranges. -
GeographyTypeName: string
Title:
Compensation Zone TypeRead Only:trueMaximum Length:255Geographical zone type used in compensation to calculate salary ranges. -
GradeCode: string
Title:
Grade CodeRead Only:trueMaximum Length:255Code for the current grade. -
GradeId: integer
(int64)
Title:
GradeUnique identifier for the assignment grade. -
GradeLadderName: string
Title:
Grade LadderRead Only:trueMaximum Length:255Name of the grade ladder associated with the person's assignment. -
GradeName: string
Title:
GradeRead Only:trueMaximum Length:255Name of the step associated with the person's assignment. -
GradeStepName: string
Title:
Grade StepRead Only:trueMaximum Length:255Name of the grade associated with the person's assignment. -
hasFutureSalary: string
Read Only:
trueMaximum Length:255Indicates whether a future salary exists. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueIdentifies the date and time that the row was most recently updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64Identifies the user who most recently updated the row. -
LegalEmployerName: string
Title:
Legal EmployerRead Only:trueMaximum Length:255Legal employer for the person's assignment. -
LegislativeDataGroupId: integer
(int64)
Read Only:
trueUnique identifier for the legislative data group. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MultipleComponents: string
Title:
Use salary componentsMaximum Length:30Indicates whether the given salary record has any child records that are either Components, Simple Components, or Rates. -
NextSalReviewDate: string
(date)
Title:
Next Salary Review DateDate to review a person's assignment salary. -
PayrollFactor: number
Payroll multiplier used to convert the salary amount to an annual salary amount, when the frequency is chosen as payroll period.
-
PayrollFrequencyCode: string
Title:
FrequencyMaximum Length:40Code for the payroll frequency when the frequency is chosen as payroll period. -
PendingTransactionExists: string
Maximum Length:
255Indicates if a salary change for the person assignment is pending approval. -
PersonDisplayName: string
Read Only:
trueMaximum Length:255Display name of the person. -
PersonId: integer
(int64)
Person identifier for the worker.
-
PersonNumber: string
Read Only:
trueMaximum Length:255Number of the person. -
Quartile: string
Title:
QuartileMaximum Length:30Quartile containing the worker's salary. The salary range for the worker's grade is divided into four equal parts called quartiles. -
QuartileMeaning: string
Title:
QuartileMaximum Length:255Lookup code meaning of the quartile containing the worker's salary. -
Quintile: string
Title:
QuintileMaximum Length:30Quintile containing the worker's salary. The salary range for the worker's grade is divided into five equal parts called quintiles. -
QuintileMeaning: string
Title:
QuintileMaximum Length:255Lookup code meaning of the quintile containing the worker's salary. -
RangeErrorWarning: string
Read Only:
trueMaximum Length:30Indicates the salary range violation behavior for the salary basis, such as error, warning, or none. -
RangePosition: number
Title:
Range PositionPosition of the worker's salary within the assignment grade salary range, expressed as a percentage of 100. -
RangeRoundingCode: string
Read Only:
trueMaximum Length:30Code for the salary range rounding rule. -
SalaryAmount: number
Title:
Salary AmountSalary amount on the salary record for the worker assignment. -
SalaryAmountScale: integer
(int32)
Decimal precision of the salary amount, configured in salary basis.
-
SalaryBasisId: integer
(int64)
Unique identifier for the salary basis.
-
SalaryBasisName: string
Read Only:
trueMaximum Length:80Name of the salary basis. -
SalaryBasisType: string
Maximum Length:
30Type of the salary basis, such as Salary amount determined by the user or Components. -
salaryComponents: array
Salary Components
Title:
Salary ComponentsThe salaryComponents resource is the child of the salaries resource and includes all the components that itemize salary adjustments for a given salary record, such as Adjustment, Location, and Merit. -
SalaryFactor: number
Title:
Salary Annualization FactorMultiplier that converts the salary amount to an annual salary amount. For example, if a worker's base pay is quoted hourly, the annualization factor is 2080 (40 hours per week x 52 weeks). -
SalaryFrequencyCode: string
Title:
FrequencyMaximum Length:30Code of the salary basis frequency, such as ANNUAL, MONTHLY, HOURLY. -
SalaryId: integer
(int64)
Unique identifier for a salary record generated by the application.
-
salaryPayRateComponents: array
Salary Rate Components
Title:
Salary Rate ComponentsThe salaryRateComponents resource is the child of the salaries resource and includes all of the rate components for a given salary record. This resource is currently under controlled availability. -
SalaryRangeDefaultValue: number
Value based on the worker assignment grade and grade rate attached with the salary basis.
-
SalaryRangeMaximum: number
Title:
Salary Range MaximumSalary range maximum based on the worker assignment grade. -
SalaryRangeMidPoint: number
Title:
Salary Range MidpointSalary range midpoint based on the worker assignment grade. -
SalaryRangeMinimum: number
Title:
Salary Range MinimumSalary range minimum based on the worker assignment grade. -
salarySimpleComponents: array
Salary Simple Components
Title:
Salary Simple ComponentsThe salarySimpleComponents resource is the child of the salaries resource and includes all of the simple components for a given salary record, such as Base Salary, Location Allowance, and Special Allowance. -
SalaryTransactionStatus: string
Maximum Length:
20Indicate whether the salary in cache is new or a correction. The approver scenario in the salary history action uses this information during edits. -
SearchDate: string
Read Only:
trueDate used to find the applicable salary for the day. -
WorkAtHome: string
Read Only:
trueMaximum Length:255Indicates whether the worker is working from home or not.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Salary Components
Type:
arrayTitle:
Salary ComponentsThe salaryComponents resource is the child of the salaries resource and includes all the components that itemize salary adjustments for a given salary record, such as Adjustment, Location, and Merit.
Show Source
Nested Schema : Salary Rate Components
Type:
arrayTitle:
Salary Rate ComponentsThe salaryRateComponents resource is the child of the salaries resource and includes all of the rate components for a given salary record. This resource is currently under controlled availability.
Show Source
Nested Schema : Salary Simple Components
Type:
arrayTitle:
Salary Simple ComponentsThe salarySimpleComponents resource is the child of the salaries resource and includes all of the simple components for a given salary record, such as Base Salary, Location Allowance, and Special Allowance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : salaries-salaryComponents-item-response
Type:
Show Source
object-
AdjustmentAmount: number
Title:
Adjustment AmountChange amount for a component used to itemize salary into different reasons. -
AdjustmentPercentage: number
Title:
Adjustment PercentageChange percentage for a component used to itemize salary into different reasons. -
ChangeAmountScale: integer
(int32)
Decimal precision of the salary amount, configured in salary basis.
-
ComponentName: string
Title:
ComponentRead Only:trueMaximum Length:80Incremental component that itemizes salary adjustments by reasons, such as merit, location, and cost of living. -
ComponentReasonCode: string
Title:
ComponentMaximum Length:30Incremental component code for salary adjustments itemized by reasons, such as merit, location, and cost of living. -
DisplaySequence: integer
(int64)
Title:
Display SequenceRead Only:trueSequence for the rate definition defined in the salary basis. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
SalaryComponentId: integer
(int64)
Unique identifier of the salary component.
-
SalaryId: integer
(int64)
Unique identifier of the salary.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : salaries-salaryPayRateComponents-item-response
Type:
Show Source
object-
AmountEnterable: string
Title:
User EnterableRead Only:trueMaximum Length:30Indicates whether the rate amount is enterable. -
FactorEnterable: string
Read Only:
trueMaximum Length:30Indicates whether the rate factor is enterable. -
FTEFlag: boolean
Title:
FTERead Only:trueMaximum Length:30Indicates whether the rate is prorated for full time equivalent. Valid values are Yes and No, and the default value is No. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
Rate NameRead Only:trueMaximum Length:256Name of the salary rate component, which can be configured to capture an amount, factor, or derived. -
PayRateDefinitionId: integer
(int64)
Title:
ComponentUnique identifier of the rate definition. -
RateAdjustmentAmount: number
Title:
Adjustment AmountChange amount for a rate definition. -
RateAdjustmentPercent: number
Title:
Adjustment PercentageChange percentage for a rate definition. -
RateAmount: number
Title:
AmountAmount on the rate component of the person's salary. -
RateAnnualAmount: number
Title:
Annual AmountAnnual value of the rate amount. -
RateAnnualFtAmount: number
Title:
Annualized Full-Time AmountAnnual value of the rate amount, if the worker was working full time. -
RateComponentRange: string
Read Only:
trueMaximum Length:255Range the rate component value should be between. -
RateCurrencyCode: string
Title:
CurrencyMaximum Length:30Currency code that the rate is stored in, such as USD. -
RateDisplaySequence: integer
(int32)
Title:
Display SequenceDisplay sequence of the rate component. -
RateFactor: number
Title:
PercentagePercentage on the rate component of the person's salary. -
RateFrequencyName: string
Title:
FrequencyRead Only:trueMaximum Length:255Frequency of the rate definition, such as Annually, Monthly, Weekly, or Hourly. -
RateMaximumAmount: number
Maximum value allowed for the rate component.
-
RateMinimumAmount: number
Minimum value required for the rate component.
-
RateOverallSalaryFlag: boolean
Read Only:
trueMaximum Length:30Indicates whether the rate is an overall salary type. Valid values are Yes and No, and the default value is No. -
RatePeriodicityCode: string
Title:
FrequencyMaximum Length:30Code of the rate periodicity, such as ANNUAL, MONTHLY, or HOURLY. -
RatePreviousAmount: number
Previous rate definition amount.
-
RateScale: integer
(int64)
Decimal precision of the rate definition.
-
RateType: string
Maximum Length:
30Type of the rate, such as Primary or Derived. -
ReturnPrecision: integer
(int64)
Read Only:
trueDecimal precision of the returned rate value. -
SalaryId: integer
(int64)
Unique identifier of the salary.
-
SalaryPayComponentId: integer
(int64)
Unique identifier of the salary rate component.
-
ShortName: string
Title:
Short NameRead Only:trueMaximum Length:30Short name of the salary rate component.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : salaries-salarySimpleComponents-item-response
Type:
Show Source
object-
AdjustmentAmount: number
Title:
Adjustment AmountChange amount for a simple component. -
AdjustmentPercent: number
Title:
Adjustment PercentageChange percentage for a simple component. -
Amount: number
Title:
AmountAmount of the person's salary entered on the simple component -
AnnualAmount: number
Title:
Annual AmountAnnual value of the simple component amount. -
AnnualFtAmount: number
Title:
Annualized Full-Time AmountAnnual value of the simple component amount, if the person worked full time. -
BasedOnComponentCode: string
Maximum Length:
30Code of the simple component that the percentage applies to. -
BasedOnComponentName: string
Name of the simple component that the percentage applies to.
-
BasisSimpleComponentId: integer
(int64)
Unique identifier of the simple component that the percentage applies to.
-
ComponentCode: string
Title:
Salary Component CodeMaximum Length:30Code of the salary simple component, such as ORA_BASIC. -
ComponentName: string
Title:
ComponentName of the simple component, which can be configured to accept an amount or percentage. -
ComponentType: string
Title:
TypeMaximum Length:30Code for the simple component type. -
CurrencyCode: string
Title:
CurrencyMaximum Length:30Currency code that the simple component value is stored in, such as USD. -
DisplaySequence: integer
(int32)
Title:
Display SequenceDisplay sequence of the simple component. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
OverallSalaryAffect: string
Title:
Overall SalaryMaximum Length:30Code for the effect of overall salary. -
OverrideGspRate: string
Maximum Length:
30Indicates whether a user can override the value defaulted from the progression ladder. -
Percentage: number
Title:
PercentagePercentage entered for the simple component. This percentage is applied to the specified based on simple component, to calculate the component amount. For example, apply 5% to the Base Salary simplified component. -
PreviousAmount: number
Title:
Previous Rate AmountPrevious simple component amount. -
SalaryId: integer
(int64)
Unique identifier of the salary.
-
Scale: integer
(int32)
Decimal precision of the salary amount, configured in salary basis.
-
SimpleSalaryCompntId: integer
(int64)
Unique identifier of the salary simple component.
-
UserSelectedComponent: string
Maximum Length:
30Property used to specify whether the incremental components type is SELECTED_COMPONENTS or USER_DECIDES_USAGE.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- salaryComponents
-
Parameters:
- SalaryId:
$request.path.SalaryId
The salaryComponents resource is the child of the salaries resource and includes all the components that itemize salary adjustments for a given salary record, such as Adjustment, Location, and Merit. - SalaryId:
- salaryPayRateComponents
-
Parameters:
- SalaryId:
$request.path.SalaryId
The salaryRateComponents resource is the child of the salaries resource and includes all of the rate components for a given salary record. This resource is currently under controlled availability. - SalaryId:
- salarySimpleComponents
-
Parameters:
- SalaryId:
$request.path.SalaryId
The salarySimpleComponents resource is the child of the salaries resource and includes all of the simple components for a given salary record, such as Base Salary, Location Allowance, and Special Allowance. - SalaryId: