--- updatedAt: 2026-02-10T18:50:36.000Z agentTools: siteIndex: https://developer.paylocity.com/llms.txt projectIndex: https://developer.paylocity.com/integrations/llms.txt --- # Get Earning Codes **Summary Description** The GET Earning Codes List by Company ID endpoint, retrieves a comprehensive list of Earning Codes from the Paylocity system with each call. Earning codes, also known as earning kinds or pay codes, are alphanumeric or numeric labels employed by organizations to classify and monitor various forms of earnings or income that employees get as part of their compensation. These codes have multiple crucial applications in payroll management, accounting, and compensation administration. Pagination can be achieved by using the "earnings" parameter and specifying the values of "limit" and "offset" to decide the quantity of records to be retrieved. The utilization of the "limit" option permits the user to restrict the quantity of rows that are retrieved from a query, whereas the "offset" option enables the omission of a designated number of rows preceding the commencement of the result set. The utilization of both the limit and offset parameters in a query allows for the skipping of rows as well as the restriction of the number of rows returned. **Use Cases** - The API enables payroll departments to oversee earning codes linked to various forms of compensation, such as standard salary, overtime, bonuses, and incentives. This guarantees precise and effective payroll computations. - Compensation Management: HR teams can employ the API to view earning codes for diverse work titles and staff groups. This allows firms to maintain alignment with compensation policies and industry norms. - Benefits Administration involves the inclusion of earning codes that contain not just wage components but also other benefits like as health insurance, retirement contributions, and stock options. The API facilitates the monitoring and administration of these varied compensation components. - Time and Attendance Integration: By integrating with time and attendance systems, the API may automate the computation of earnings using data on hours worked, shifts, and attendance. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Company Level Information", "version": "v1" }, "servers": [ { "url": "dc1demogwext.paylocity.com" } ], "paths": { "/apiHub/payroll/v1/companies/{companyId}/earnings": { "get": { "tags": [ "Payroll/HR" ], "summary": "Get Earning Codes", "description": "**Summary Description**\n\nThe GET Earning Codes List by Company ID endpoint, retrieves a comprehensive list of Earning Codes from the Paylocity system with each call. Earning codes, also known as earning kinds or pay codes, are alphanumeric or numeric labels employed by organizations to classify and monitor various forms of earnings or income that employees get as part of their compensation. These codes have multiple crucial applications in payroll management, accounting, and compensation administration. Pagination can be achieved by using the \"earnings\" parameter and specifying the values of \"limit\" and \"offset\" to decide the quantity of records to be retrieved. The utilization of the \"limit\" option permits the user to restrict the quantity of rows that are retrieved from a query, whereas the \"offset\" option enables the omission of a designated number of rows preceding the commencement of the result set. The utilization of both the limit and offset parameters in a query allows for the skipping of rows as well as the restriction of the number of rows returned.\n\n**Use Cases**\n\n- The API enables payroll departments to oversee earning codes linked to various forms of compensation, such as standard salary, overtime, bonuses, and incentives. This guarantees precise and effective payroll computations.\n- Compensation Management: HR teams can employ the API to view earning codes for diverse work titles and staff groups. This allows firms to maintain alignment with compensation policies and industry norms.\n- Benefits Administration involves the inclusion of earning codes that contain not just wage components but also other benefits like as health insurance, retirement contributions, and stock options. The API facilitates the monitoring and administration of these varied compensation components.\n- Time and Attendance Integration: By integrating with time and attendance systems, the API may automate the computation of earnings using data on hours worked, shifts, and attendance.\n", "x-explorer-enabled": false, "parameters": [ { "name": "companyId", "in": "path", "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\r\n **Allowable Values:**\r\n 9 char max", "required": true, "schema": { "type": "string" }, "example": "A12345" }, { "name": "Authorization", "in": "header", "description": "Authorization token. Ex. Bearer ...", "schema": { "type": "string" } }, { "name": "includeTotalCount", "in": "query", "description": "A boolean value representing whether the API should return the total number of resources available (even though only a subset may be returned). When includeTotalCount=true, then the X-Pcty-Total-Count response header should be added to the response and will specify the total number of records available. APIs that support X-Pcty-Total-Count should include this parameter in their specification.", "schema": { "type": "boolean", "default": true } }, { "name": "testMode", "in": "header", "description": "If true all responses are mocked and generated randomly.", "schema": { "type": "boolean", "default": false } }, { "name": "limit", "in": "query", "description": "Number of earning codes per page.\r\n **Default Value:** 20\r\n **Maximum Value:** 100", "schema": { "type": "integer", "format": "int32", "default": 20 }, "example": 5 }, { "name": "offset", "in": "query", "description": "Pagination offset.", "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/EarningCodesDto" } } } } } } } } }, "components": { "schemas": { "CompanyEarningTypeDto": { "type": "object", "properties": { "code": { "type": "string", "description": "The code representing the earning type.", "nullable": true }, "description": { "type": "string", "description": "The category to which the earning type belongs.", "nullable": true }, "calculationCode": { "type": "string", "description": "The code used for calculating the earning type.", "nullable": true }, "overrideCalculationCode": { "type": "string", "description": "The overridden calculation code for the earning type.", "nullable": true }, "w2Box": { "type": "string", "description": "The W-2 box associated with the earning type.", "nullable": true }, "isFringeBenefit": { "type": "boolean", "description": "Indicates whether the earning type is a garnishment.", "nullable": true } }, "additionalProperties": { "type": "object", "nullable": true } }, "EarningCodesDto": { "type": "object", "properties": { "companyId": { "type": "string", "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.", "nullable": true }, "code": { "type": "string", "description": "Unique identifier for specific types of earnings associated with employees' compensation packages. It plays a crucial role in accurately calculating, categorizing, and recording various forms of income and compensation.", "nullable": true }, "description": { "type": "string", "description": "A detailed textual explanation or label that provides additional context and meaning to the associated code or entity.", "nullable": true }, "checkStubDescription": { "type": "string", "description": "A descriptive text that appears on an employee's check stub, offering transparency and clarity regarding the payment.", "nullable": true }, "w2Box": { "type": "string", "description": "A reference to a specific box on a W-2 tax form, aiding in the accurate reporting of various types of income and deductions.", "nullable": true }, "printOnCheckStub": { "type": "string", "description": "An indicator specifying whether the associated information or description should be printed on an employee's check stub.", "nullable": true }, "payPeriodMaximum": { "type": "number", "description": "The maximum limit or threshold applicable to a pay period, often used to define the upper limit of compensation within a specific period.", "format": "double", "nullable": true }, "payPeriodMinimum": { "type": "number", "description": "The minimum threshold or floor amount for compensation within a pay period, ensuring that compensation meets a minimum standard.", "format": "double", "nullable": true }, "annualMaximum": { "type": "number", "description": "The highest allowable amount or limit for compensation within an annual period, setting an upper boundary for earnings.", "format": "double", "nullable": true }, "overrideRate": { "type": "number", "description": "An overridden rate for the earning.", "format": "double", "nullable": true }, "addToRate": { "type": "number", "description": "A field indicating whether a specific amount should be added to an existing rate or compensation structure.", "format": "double", "nullable": true }, "rateMultiplier": { "type": "number", "description": "A numerical multiplier used to calculate rates or compensation, allowing for flexible rate adjustments.", "format": "double", "nullable": true }, "calculationCode": { "type": "string", "description": "A code used in calculations to determine specific values or outcomes, assisting in complex computation scenarios.", "nullable": true }, "rateCode": { "type": "string", "description": "The code associated with the earning rate.", "nullable": true }, "amount": { "type": "number", "description": "The numerical value representing a specific amount, often used in financial calculations and compensation.", "format": "double", "nullable": true }, "frequency": { "type": "string", "description": "The frequency at which the earning is taken (e.g., weekly, monthly).", "nullable": true }, "rate": { "type": "number", "description": "The rate of compensation associated with a particular entity or item, indicating payment per unit of time or work.", "format": "double", "nullable": true }, "agency": { "type": "string", "description": "The agency or organization associated with the earning.", "nullable": true }, "relatedDeductionCode": { "type": "string", "description": "The code of the related deduction, if applicable.", "nullable": true }, "reduceAutoPay": { "type": "boolean", "description": "An indicator specifying whether automatic payments should be reduced based on certain conditions or criteria.", "nullable": true }, "exemptTaxes": { "type": "array", "items": { "type": "string" }, "description": "An array of tax codes from which the earning is exempt.", "nullable": true }, "blockedTaxes": { "type": "array", "items": { "type": "string" }, "description": "An array of tax codes that are blocked from applying to the earning.", "nullable": true }, "costCenterMatrixId": { "type": "integer", "description": "An identifier that associates an entity or item with a cost center matrix, facilitating cost allocation and tracking.", "format": "int32", "nullable": true }, "isActive": { "type": "boolean", "description": "An indicator denoting the current status or active state of an entity or item, assisting in management and decision-making.", "nullable": true }, "includeInHoursWorked": { "type": "boolean", "description": "An indicator specifying whether the associated data should be included in calculations related to hours worked.", "nullable": true }, "includeOnYtdCompChart": { "type": "boolean", "description": "An indicator specifying whether the data should be included on a year-to-date compensation chart or report.", "nullable": true }, "source": { "type": "integer", "description": "The origin or source of data, indicating where the information was derived or obtained from within the system.", "format": "int32", "nullable": true }, "wasUsedInPayroll": { "type": "boolean", "description": "An indicator confirming whether the data was utilized in payroll processing, ensuring transparency in payroll calculations.", "nullable": true }, "benefitType": { "type": "string", "description": "The type of benefit associated with the earning.", "nullable": true }, "selfInsured": { "type": "boolean", "description": "An indicator indicating whether an entity or item is self-insured, meaning it assumes responsibility for insurance coverage.", "nullable": true }, "isEmployerPaidMedicalLeave": { "type": "boolean", "description": "An indicator specifying whether an entity or item is related to employer-paid medical leave, offering clarity on benefit coverage.", "nullable": true }, "classificationCode": { "type": "string", "description": "The classification code associated with the earning.", "nullable": true }, "wageType": { "type": "string", "description": "The type of wage associated with the earning.", "nullable": true }, "type": { "$ref": "#/components/schemas/CompanyEarningTypeDto" } }, "additionalProperties": { "type": "object", "nullable": true } } } } } ```