Skip to navigation

Get Cost Centers/Labor Levels

View as Markdown

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

companyIdstringRequired

Paylocity company identifier (COID): up to 9 alphanumeric characters for the target company.

Headers

testModebooleanOptional
If true all responses are mocked and generated randomly.
AcceptstringOptional

Media type(s) the client can accept in the response (typically application/json).

Query parameters

limitintegerOptional

The number of records to return. The default is 25. The maximum is 1000. Used together with offset for offset/limit pagination.

offsetintegerOptional

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. Uses item-index offset semantics: this is the number of resources to skip (not a page number). Pair with limit for paging.

includeTotalCountbooleanOptional

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

Response headers

X-Pcty-Total-Countinteger

When the request sets includeTotalCount=true, the API returns this header with the total number of resources available (even if only one page is returned).

Response

Successful response

Errors

401
Unauthorized Error