v1

latestOpenAPI 3.0.42026-07-2481154567.6 KB
Time and Labor

GET Cost Centers/Labor Levels

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.
get/apiHub/time/v1/companies/{companyId}/costCenters

Path parameters

companyIdstring required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.

Query parameters

limitinteger

The number of records to return. The default is 25. The maximum is 1000.

offsetinteger

The number of records to offset the results by. For instance, a value of 0 will begin the results at the first record, but a value of 100 will start with the 101st record.

includeTotalCountboolean

If true, adds X-Pcty-Total-Count header with the total count of results for the query.

Headers

Authorizationstring

Authorization token. Ex. Bearer ...

testModeboolean

If true all responses are mocked and generated randomly.

Response

Successful operation

idstring uuid

The unique identifier for the cost center.

costCenterIdinteger

A unique identifier for a specific cost center within the organizational structure, allowing for precise identification and association with financial data and operations.

levelinteger

The level or rank of the cost center within the organizational hierarchy, indicating its position and importance within the organization's structure.

codestring nullable

A code or label representing the cost center, aiding in its categorization and differentiation within the organization's financial and operational framework.

namestring 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.