Get all salaries for a worker's assignment

get

/hcmRestApi/resources/11.13.18.05/salaries

Request

Query Parameters
  • 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 the salary that matches the specified primary key criteria.
      Finder Variables
      • SalaryId; integer; Unique identifier of the salary for a worker assignment.
    • findAssignmentSalaryHistory Finds all salaries for the assignment that matches the specified criteria.
      Finder Variables
      • AssignmentId; integer; Unique identifier for a worker assignment.
      • EffectiveStartDate; string; Date used to find the salary applicable for the day.
    • findByAssignmentId Finds all salaries that match the specified criteria.
      Finder Variables
      • AssignmentId; integer; Unique identifier of a worker assignment.
    • findByAssignmentIdAndDate Finds all salaries that match the specified criteria.
      Finder Variables
      • AssignmentId; integer; Unique identifier of a worker assignment.
      • EffectiveDate; string; Date used to find the salary applicable for the day.
    • findByCoreHrParams Finds the salary that matches the specified criteria.
      Finder Variables
      • AssigGradeLadderId; integer; Surrogate identifier for the current grade ladder.
      • AssigGradeStepId; integer; Surrogate identifier of the current assignment grade step.
      • AssignmentId; integer; Unique identifier for the assignment.
      • BusinessUnitId; integer; Unique identifier for the business unit.
      • DateFrom; string; Start date of the salary.
      • DateTo; string; End date of the salary.
      • FTEValue; number; Factor that represents the proportion of full-time hours a person works.
      • GradeId; integer; Unique identifier for the assignment grade.
      • JobId; integer; Unique identifier of the job.
      • LocationId; integer; Unique identifier for the location.
      • RestFlow; string; The action or flow using the REST operation, such as for Hire, Promote, or Local and Global Transfer.
      • SalaryAmount; number; Salary amount on the salary record for the worker assignment.
      • SalaryBasisId; integer; Unique identifier of the salary basis.
      • SalaryId; integer; Unique identifier for the salary.
      • WorkAtHome; string; Lookup code to indicate work-from-home status of a remote worker.
    • findBySalaryId Finds the salary that matches the specified criteria.
      Finder Variables
      • SalaryId; integer; Unique identifier of the salary for a worker assignment.
    • findOfferSalaryView Finds all salaries for the assignment that matches the specified criteria.
      Finder Variables
      • AssignmentId; integer; Unique identifier for a worker assignment.
      • OfferId; integer; Unique identifier for an offer.
      • PersonId; integer; Unique identifier for the person.
    • findSalaryAfterReload Finds the salary that matches the specified criteria.
      Finder Variables
      • AssignmentId; integer; Unique identifier for a worker assignment.
      • ReloadTransactionId; integer; Unique identifier for the salary transaction.
      • SearchDate; string; Date used to find the salary applicable for the day.
  • 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:
    • ActionCode; string; Code of the action.
    • ActionId; integer; Unique identifier of the action.
    • ActionName; string; Action being done on this assignment, such as, Hire, Add Pending Worker, Manager Change and so on. Valid values are defined in the actionsLOV.
    • ActionReason; string; Reason for the action being done on the record. Valid values are defined in the actionReasonsLOV.
    • ActionReasonCode; string; Code of the action reason.
    • ActionReasonId; integer; Unique identifier of the action reason.
    • AdjustmentAmount; number; Calculated adjustment amount based on the previous salary.
    • AdjustmentPercentage; number; Calculated adjustment percentage based on the previous salary .
    • AmountDecimalPrecision; number; Decimal precision of the salary amount, configured in salary basis.
    • AmountRoundingCode; string; Code for the salary amount rounding rule.
    • AnnualFullTimeSalary; number; Annual value of the worker's salary, if working full time.
    • AnnualRoundingCode; string; Code for the annualized salary amount rounding rule.
    • AnnualSalary; number; Annual value of the worker's salary.
    • AssignmentId; integer; Unique identifier for the assignment.
    • AssignmentNumber; string; Assignment number for the given assignment.
    • AssignmentType; string; Type of assignment, such as an employee, contingent worker, nonworker, or pending worker.
    • BusinessTitle; string; Business title for the given assignment.
    • Code; string; Code for the salary basis.
    • CompaRatio; number; Salary as a percentage of the grade range midpoint. Salary at the midpoint is 100.
    • ComponentUsage; string; Property used to specify whether the incremental components type is SELECTED_COMPONENTS or USER_DECIDES_USAGE.
    • CreatedBy; string; Identifies the user who created the row.
    • CreationDate; string; Identifies the date and time that the row was created.
    • CurrencyCode; string; Currency code that the salary amount is stored in, such as USD.
    • DateFrom; string; Start date of the salary.
    • DateTo; string; End date of the salary.
    • DisplayName; string; Unique 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.
    • FTEValue; number; Factor that represents the proportion of full-time hours a person works.
    • FrequencyName; string; Frequency of the salary basis, such as Annually, Monthly, Weekly, or Hourly.
    • GeographyName; string; Geographical zone used in compensation to calculate salary ranges.
    • GeographyTypeName; string; Geographical zone type used in compensation to calculate salary ranges.
    • GradeCode; string; Code for the current grade.
    • GradeId; integer; Unique identifier for the assignment grade.
    • GradeLadderName; string; Name of the grade ladder associated with the person's assignment.
    • GradeName; string; Name of the step associated with the person's assignment.
    • GradeStepName; string; Name of the grade associated with the person's assignment.
    • LastUpdateDate; string; Identifies the date and time that the row was most recently updated.
    • LastUpdatedBy; string; Identifies the user who most recently updated the row.
    • LegalEmployerName; string; Legal employer for the person's assignment.
    • LegislativeDataGroupId; integer; Unique identifier for the legislative data group.
    • MultipleComponents; string; Indicates whether the given salary record has any child records that are either Components, Simple Components, or Rates.
    • NextSalReviewDate; string; Date 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; Code for the payroll frequency when the frequency is chosen as payroll period.
    • PendingTransactionExists; string; Indicates if a salary change for the person assignment is pending approval.
    • PersonDisplayName; string; Display name of the person.
    • PersonId; integer; Person identifier for the worker.
    • PersonNumber; string; Number of the person.
    • Quartile; string; Quartile containing the worker's salary. The salary range for the worker's grade is divided into four equal parts called quartiles.
    • QuartileMeaning; string; Lookup code meaning of the quartile containing the worker's salary.
    • Quintile; string; Quintile containing the worker's salary. The salary range for the worker's grade is divided into five equal parts called quintiles.
    • QuintileMeaning; string; Lookup code meaning of the quintile containing the worker's salary.
    • RangeErrorWarning; string; Indicates the salary range violation behavior for the salary basis, such as error, warning, or none.
    • RangePosition; number; Position of the worker's salary within the assignment grade salary range, expressed as a percentage of 100.
    • RangeRoundingCode; string; Code for the salary range rounding rule.
    • SalaryAmount; number; Salary amount on the salary record for the worker assignment.
    • SalaryAmountScale; integer; Decimal precision of the salary amount, configured in salary basis.
    • SalaryBasisId; integer; Unique identifier for the salary basis.
    • SalaryBasisName; string; Name of the salary basis.
    • SalaryBasisType; string; Type of the salary basis, such as Salary amount determined by the user or Components.
    • SalaryFactor; number; Multiplier 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; Code of the salary basis frequency, such as ANNUAL, MONTHLY, HOURLY.
    • SalaryId; integer; Unique identifier for a salary record generated by the application.
    • SalaryRangeMaximum; number; Salary range maximum based on the worker assignment grade.
    • SalaryRangeMidPoint; number; Salary range midpoint based on the worker assignment grade.
    • SalaryRangeMinimum; number; Salary range minimum based on the worker assignment grade.
    • SearchDate; string; Date used to find the applicable salary for the day.
    • WorkAtHome; string; Indicates whether the worker is working from home or not.
    • hasFutureSalary; string; Indicates whether a future salary exists.
  • 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
  • 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 : salaries
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : salaries-item-response
Type: object
Show Source
Nested Schema : Salary Components
Type: array
Title: Salary Components
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.
Show Source
Nested Schema : Salary Rate Components
Type: array
Title: Salary Rate Components
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.
Show Source
Nested Schema : Salary Simple Components
Type: array
Title: Salary Simple Components
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.
Show Source
Nested Schema : salaries-salaryComponents-item-response
Type: object
Show Source
Nested Schema : salaries-salaryPayRateComponents-item-response
Type: object
Show Source
Nested Schema : salaries-salarySimpleComponents-item-response
Type: object
Show Source
Back to Top