--- updatedAt: 2026-02-10T18:50:36.000Z agentTools: siteIndex: https://developer.paylocity.com/llms.txt projectIndex: https://developer.paylocity.com/integrations/llms.txt --- # Get Tax Codes **Summary Description** The GET Tax Codes by list by Company ID endpoint allows users to retrieve a comprehensive list of Tax Codes details from a client's Paylocity instance. To use this endpoint, the Paylocity “taxes” parameter must be specified. Tax codes serve as a means for tax authorities and organizations to categorize various forms of taxes and tax-related data. These codes facilitate precise computation, reporting, and adherence to diverse tax responsibilities. Tax codes are jurisdiction-specific and can vary substantially between different locations. Pagination can be achieved by using the "taxes" 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. “includeTotalCount” parameter can also be used to return the total number of resources available (even though only a subset may be returned). **Use Cases** - The process of calculating income tax involves the utilization of tax codes, which serve to calculate the appropriate income tax rates and brackets for both people and businesses. Distinct tax codes may be applicable to different income thresholds, filing statuses, and categories of income (such as capital gains and dividends). - Payroll Deductions: Employers utilize tax codes to accurately compute and retain the appropriate amount of income tax, Social Security tax, and Medicare tax from employees' wages. These codes serve to guarantee that employees have the accurate amount of tax deducted throughout the year. # 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}/taxes": { "get": { "tags": [ "Payroll/HR" ], "summary": "Get Tax Codes", "description": "**Summary Description**\n\nThe GET Tax Codes by list by Company ID endpoint allows users to retrieve a comprehensive list of Tax Codes details from a client's Paylocity instance. To use this endpoint, the Paylocity “taxes” parameter must be specified. Tax codes serve as a means for tax authorities and organizations to categorize various forms of taxes and tax-related data. These codes facilitate precise computation, reporting, and adherence to diverse tax responsibilities. Tax codes are jurisdiction-specific and can vary substantially between different locations.\r\n\r\nPagination can be achieved by using the \"taxes\" 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. “includeTotalCount” parameter can also be used to return the total number of resources available (even though only a subset may be returned).\n\n**Use Cases**\n\n- The process of calculating income tax involves the utilization of tax codes, which serve to calculate the appropriate income tax rates and brackets for both people and businesses. Distinct tax codes may be applicable to different income thresholds, filing statuses, and categories of income (such as capital gains and dividends).\n- Payroll Deductions: Employers utilize tax codes to accurately compute and retain the appropriate amount of income tax, Social Security tax, and Medicare tax from employees' wages. These codes serve to guarantee that employees have the accurate amount of tax deducted throughout the year.\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": "testMode", "in": "header", "description": "If true all responses are mocked and generated randomly.", "schema": { "type": "boolean", "default": false } }, { "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": "offset", "in": "query", "description": "Pagination offset.", "schema": { "type": "integer", "format": "int32", "default": 0 } }, { "name": "limit", "in": "query", "description": "Number of tax codes per page.\r\n **Default Value:** 20\r\n **Maximum Value:** 100", "schema": { "type": "integer", "format": "int32", "default": 50 }, "example": 5 } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TaxCodeDto" } } } } } } } } }, "components": { "schemas": { "TaxCodeCustomFieldDto": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the custom field.", "nullable": true }, "index": { "type": "integer", "description": "Index of the custom field.", "format": "int32", "nullable": true }, "label": { "type": "string", "description": "Label for the custom field.", "nullable": true }, "value": { "type": "string", "description": "Value of the custom field.", "nullable": true } }, "additionalProperties": { "type": "object", "nullable": true } }, "TaxCodeDto": { "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": "A distinct code representing a specific entity or item, providing a concise reference for accurate identification and categorization.", "nullable": true }, "description": { "type": "string", "description": "A detailed textual explanation or label that offers additional context and meaning to the associated code or entity.", "nullable": true }, "ein": { "type": "string", "description": "The Employee Identification Number (EIN) is a unique identifier assigned to businesses and organizations for tax-related purposes.", "nullable": true }, "startDate": { "type": "string", "description": "The date on which a specific process, program, or activity begins, serving as a reference point for timeline-related data.", "format": "date-time", "nullable": true }, "endDate": { "type": "string", "description": "End date of the tax code.", "format": "date-time", "nullable": true }, "depositFrequency": { "type": "string", "description": "A descriptor specifying the frequency at which deposits or transactions are made, aiding in financial planning and management.", "nullable": true }, "depositMethod": { "type": "string", "description": "A method or approach used for making deposits or financial transactions, offering flexibility and customization options.", "nullable": true }, "type": { "type": "string", "description": "A categorical label defining the type or category to which an entity or item belongs, enhancing organizational classification.", "nullable": true }, "depositWith": { "type": "string", "description": "A descriptor indicating the entity or account with which deposits or financial transactions are associated, providing clarity on financial relationships.", "nullable": true }, "isEmployeeTax": { "type": "boolean", "description": "An indicator specifying whether a particular element or entity is related to employee taxation, aiding in tax-related management and reporting.", "nullable": true }, "isExempt": { "type": "boolean", "description": "Indicates if the tax code is exempt.", "nullable": true }, "isSuiReimbursable": { "type": "boolean", "description": "An indicator indicating whether an item or entity is eligible for State Unemployment Insurance (SUI) reimbursement, providing clarity on financial considerations.", "nullable": true }, "isActive": { "type": "boolean", "description": "An indicator denoting the current status or active state of an entity or item, facilitating management and decision-making processes.", "nullable": true }, "isFiledWithAgency": { "type": "boolean", "description": "An indicator specifying whether an entity or item is filed with a regulatory agency, ensuring compliance and reporting transparency.", "nullable": true }, "workPsdCode": { "type": "string", "description": "Work PSD (Payment Service Delivery) code for the tax code.", "nullable": true }, "customFields": { "type": "array", "items": { "$ref": "#/components/schemas/TaxCodeCustomFieldDto" }, "description": "Array of custom fields associated with the tax code.", "nullable": true }, "rules": { "$ref": "#/components/schemas/TaxCodeRulesDto" } }, "additionalProperties": { "type": "object", "nullable": true } }, "TaxCodeRulesDto": { "type": "object", "properties": { "options": { "type": "string", "description": "Custom options or settings applicable to the entity, providing flexibility and customization capabilities.", "nullable": true }, "roundingMethod": { "type": "string", "description": "Rounding method for tax code calculations.", "nullable": true }, "requiresVarianceCalc": { "type": "integer", "description": "An indicator specifying whether the entity or item requires variance calculations, aiding in financial analysis and reporting.", "format": "int32", "nullable": true } }, "additionalProperties": { "type": "object", "nullable": true } } } } } ```