---
title: "GET Cost Centers/Labor Levels"
method: GET
path: "/apiHub/time/v1/companies/{companyId}/costCenters"
tags: ["Time and Labor"]
---

# GET Cost Centers/Labor Levels

`GET /apiHub/time/v1/companies/{companyId}/costCenters`

**Summary Description**

The GET Time and Labor Cost Center List by Company ID endpoint retrieves a comprehensive list of cost centers from the Paylocity Time and Labor system with each call. A cost center is a specific department, division, or function within an organization that incurs costs but does not directly generate revenue. This API is essential for financial reporting, budgeting, and performance management. By accessing the costCenters endpoint, you can access an up-to-date and accurate list of these entities, providing granular insight into where an organization's expenses are originating. This data is critical for budget tracking, expense allocation, and operational efficiency analysis, helping businesses make informed financial decisions.

**Use Cases**

- Automated Financial Reporting: Integrate the API into business intelligence (BI) tools or financial dashboards to automatically generate reports on departmental spending, helping to identify and analyze cost trends over time without manual data entry.
- Budget Management & Forecasting: Use the cost center data to create and manage budgets for different departments. By pulling the list of cost centers, a financial application can match them to expense data, enabling more accurate forecasting and budget variance analysis.
- Payroll & Expense Allocation: Connect the API to a payroll system to correctly allocate employee hours and labor costs to the specific cost centers they worked for. This ensures accurate billing, job costing, and departmental expense tracking.
- ERP & HCM Integration: Seamlessly integrate the Paylocity data with other Enterprise Resource Planning (ERP) or Human Capital Management (HCM) systems. This allows for a unified view of an organization's financial and personnel data, improving data consistency and streamlining operations.
- Auditing & Compliance: Retrieve a list of all cost centers for internal and external audits. The API provides a single source of truth for cost center data, ensuring compliance with accounting standards and regulations by providing a clear trail of expenses.

## Path parameters

- `companyId` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `includeTotalCount` boolean

## Headers

- `Authorization` string
- `testMode` boolean

## Response `200`

Successful operation

- CostCenterV1Model[]
  - `id` string, uuid — The unique identifier for the cost center.
  - `costCenterId` integer — A unique identifier for a specific cost center within the organizational structure, allowing for precise identification and association with financial data and operations.
  - `level` integer — The level or rank of the cost center within the organizational hierarchy, indicating its position and importance within the organization's structure.
  - `code` string, nullable — A code or label representing the cost center, aiding in its categorization and differentiation within the organization's financial and operational framework.
  - `name` string, nullable — The name or title of the cost center, offering a clear and descriptive label for easy recognition and understanding of its role and responsibilities.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Server Error

---

[API](https://skmtc.net/paylocity/apis/assessments-api.md) · [All operations](https://skmtc.net/paylocity/apis/assessments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylocity/assessments-api/revisions/dd22ab229153/schema)