GuidesReferenceChangelogAPI Upgrades
Reference

The earning rate object

Represents a custom earning rate for an employee, which can be used while creating payroll items through the API.

For more details about how to use earning rates, refer to the Earnings Guide.

{
    "id": "rte_aOSqW0QTKcE1iVU1C5",
    "amount": "50000.00",
    "period": "annually",
    "employee": "emp_aslkj192j3laksdj",
    "name": "Dishwasher Weekend Rate",
    "workweek_hours": 40.0,
    "active": true,
    "metadata": {}
}
id
string		Unique identifier for the earning rate.
amount
string		The amount to pay the employee per period. This value cannot be changed after the Earning Rate is created.
period
string		The time frame to spread the amount over. May be hourly, annually, or piece. This value cannot be changed after the Earning Rate is created.
employee
string		ID of the employee that this earning rate relates to.
name
string		Human-readable name identifying the earning rate.
workweek_hours
float		Number of hours the employee works per week, most commonly for salaried employees. Used when determining the effective hourly rate for annually earning rates. Defaults to 40.
active
boolean		Flag to filter out earning rates that are no longer in use.
metadata
object		Additional loosely structured information to associate with the earning rate.