--- updatedAt: 2026-02-10T18:50:36.000Z agentTools: siteIndex: https://developer.paylocity.com/llms.txt projectIndex: https://developer.paylocity.com/integrations/llms.txt --- # Get Cost Center Codes **Summary Description** The GET Cost Center List by Company ID endpoint, retrieves a comprehensive list of Cost Center from the Paylocity system with each call. To use this endpoint, the Paylocity “costCentersAndLevels” parameter must be specified. Cost centers are distinct entities or divisions within an organization that bear expenses as a result of their activities. These cost centers are crucial for monitoring and controlling expenses, allocating funds, and evaluating the efficiency of various departments within the firm. Cost centers are predominantly employed in managerial accounting and financial management to apportion expenses and evaluate resource utilization. Typical instances of cost centers encompass production departments, marketing teams, research and development units, and administrative offices. **Use Cases** - Cost allocation refers to the process of assigning costs that have been incurred by a specific cost center to that same center. The costs encompass staff remuneration, utility bills, rental fees, supplies, and any additional expenses related to the activities of the cost center. - Budgeting: Cost centers are essential in the process of creating a budget. Organizations distribute budgets among several cost centers and then compare the actual expenses of each center to their allocated budget. This facilitates cost management and performance assessment. - Performance Evaluation: Cost centers are assessed according to their capacity to effectively control costs while attaining their goals. Performance metrics may encompass indicators such as the cost incurred for each unit of output, the cost incurred for each employee, or other pertinent measures. - Cost Reporting: Organizations frequently produce reports for individual cost centers, providing a comprehensive breakdown of their expenditures and operational effectiveness. Management utilizes these reports to evaluate the financial well-being and effectiveness of each cost center. **Note** - A company cannot delete Cost Centers. The Cost Center is editable after use, but the chosen Code for the Cost Center is permanent. - To ensure cross-product compatibility, Cost Center Codes should not contain leading zeros or special characters. Cost Center codes must be numeric only if employees transfer using time clocks or kiosk tablets. - A Country selection is necessary before being able to enter information into the Zip and State fields when selecting the Override Company Check Printing Address option. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Company Level Information", "version": "v1" }, "servers": [ { "url": "dc1demogwext.paylocity.com" } ], "paths": { "/apiHub/corehr/v1/companies/{companyId}/costCentersAndLevels": { "get": { "tags": [ "Cost Centers" ], "summary": "Get Cost Center Codes", "description": "**Summary Description**\n\nThe GET Cost Center List by Company ID endpoint, retrieves a comprehensive list of Cost Center from the Paylocity system with each call. To use this endpoint, the Paylocity “costCentersAndLevels” parameter must be specified. Cost centers are distinct entities or divisions within an organization that bear expenses as a result of their activities. These cost centers are crucial for monitoring and controlling expenses, allocating funds, and evaluating the efficiency of various departments within the firm. Cost centers are predominantly employed in managerial accounting and financial management to apportion expenses and evaluate resource utilization. Typical instances of cost centers encompass production departments, marketing teams, research and development units, and administrative offices.\n\n**Use Cases**\n\n- Cost allocation refers to the process of assigning costs that have been incurred by a specific cost center to that same center. The costs encompass staff remuneration, utility bills, rental fees, supplies, and any additional expenses related to the activities of the cost center.\n- Budgeting: Cost centers are essential in the process of creating a budget. Organizations distribute budgets among several cost centers and then compare the actual expenses of each center to their allocated budget. This facilitates cost management and performance assessment. \n- Performance Evaluation: Cost centers are assessed according to their capacity to effectively control costs while attaining their goals. Performance metrics may encompass indicators such as the cost incurred for each unit of output, the cost incurred for each employee, or other pertinent measures. \n- Cost Reporting: Organizations frequently produce reports for individual cost centers, providing a comprehensive breakdown of their expenditures and operational effectiveness. Management utilizes these reports to evaluate the financial well-being and effectiveness of each cost center.\n\n**Note**\n\n- A company cannot delete Cost Centers. The Cost Center is editable after use, but the chosen Code for the Cost Center is permanent.\n- To ensure cross-product compatibility, Cost Center Codes should not contain leading zeros or special characters. Cost Center codes must be numeric only if employees transfer using time clocks or kiosk tablets.\n- A Country selection is necessary before being able to enter information into the Zip and State fields when selecting the Override Company Check Printing Address option.\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 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CostCenterLevelModelDto" } } } } } } } } }, "components": { "schemas": { "CostCenterLevelModelDto": { "type": "object", "properties": { "id": { "type": "integer", "description": "A unique identifier for a cost center, serving as a reference key for identification and association with specific financial or organizational entities.", "format": "int32", "nullable": true }, "level": { "type": "integer", "description": "The level or rank of the cost center within the organizational hierarchy, indicating its position and importance within the organization's structure.", "format": "int32", "nullable": true }, "description": { "type": "string", "description": "A detailed textual explanation or label that provides additional context and meaning to the cost center, enhancing understanding and clarity regarding its purpose and role.", "nullable": true }, "costCenters": { "type": "array", "items": { "$ref": "#/components/schemas/CostCenterModelDto" }, "description": "An array of objects containing cost center details.", "nullable": true } }, "additionalProperties": { "type": "object", "nullable": true } }, "CostCenterModelDto": { "type": "object", "properties": { "id": { "type": "integer", "description": "A unique identifier for a specific cost center within the organizational structure, allowing for precise identification and association with financial data and operations.", "format": "int32", "nullable": true }, "code": { "type": "string", "description": "A code or label representing the cost center, aiding in its categorization and differentiation within the organization's financial and operational framework.", "nullable": true }, "name": { "type": "string", "description": "The name or title of the cost center, offering a clear and descriptive label for easy recognition and understanding of its role and responsibilities.", "nullable": true }, "isActive": { "type": "boolean", "description": "An indicator denoting the current status or active state of the cost center, assisting in management and decision-making regarding financial operations and allocation.", "nullable": true } }, "additionalProperties": { "type": "object", "nullable": true } } } } } ```