---
title: "List cost center allocations for a company"
method: GET
path: "/v1/company/{company_id}/cost-center-allocations"
tags: ["Cost Center Allocations"]
---

# List cost center allocations for a company

`GET /v1/company/{company_id}/cost-center-allocations`

Lists all employments under a company with their cost center allocations, grouped by employment.
Each entry includes the employment's legal entity IDs and the list of cost center allocations
assigned to it, with each allocation's cost center, allocated percentage, and effective period.
Employments with no cost center allocations are included with an empty list.

Use the `status` query parameter to return only `active`, `scheduled`, or `expired` allocations.
When omitted, all allocations are returned.


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage employments (`employments`) | View employments (`employment:read`) | Manage employments (`employment:write`) |

## Path parameters

- `company_id` string, required

## Query parameters

- `status` 'active' | 'scheduled' | 'expired'
- `page` integer
- `page_size` integer

## Response `200`

Success

- ListCompanyCostCenterAllocationsResponse — Response schema listing many employments
  - `data` object
    - `current_page` integer — The current page among all of the total_pages
    - `employments` EmploymentWithCostCenterAllocations[]
      - `bill_to_legal_entity_id` string, nullable — Unique identifier of the legal entity this employment is billed to.
      - `cost_center_allocations` CostCenterAllocation[], required — The cost center allocations for this employment.
        - `cost_center` CostCenter, required — The cost center an employment is allocated to.
          - `code` string, nullable, required — Cost center code. Typically used as the join key to an external general ledger.
          - `name` string, required — Cost center name.
          - `slug` string, required — Unique identifier of the cost center.
        - `effective_from` string, date, nullable, required — Date the allocation becomes effective.
        - `effective_to` string, date, nullable, required — Date the allocation stops being effective.
        - `id` string, uuid, required — Unique identifier of the cost center allocation.
        - `percentage` number, float, required — Percentage of the employment's cost allocated to this cost center (0-100).
        - `status` 'active' | 'scheduled' | 'expired', required — Allocation status, derived from the effective period.
      - `employment_id` string, required — Unique identifier of the employment.
      - `engaged_by_legal_entity_id` string, nullable — Unique identifier of the legal entity that employs this employment.
    - `total_count` integer — The total number of records in the result
    - `total_pages` integer — The total number of pages the user can go through

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Entity
- `429` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)