---
title: "List cost center allocations for an employment"
method: GET
path: "/v1/employments/{employment_id}/cost-center-allocations"
tags: ["Cost Center Allocations"]
---

# List cost center allocations for an employment

`GET /v1/employments/{employment_id}/cost-center-allocations`

Lists the cost center allocations for an employment. Each allocation includes the cost center,
the allocated percentage, and its effective period. An employment with no cost center assigned
returns 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

- `employment_id` string, required

## Query parameters

- `status` 'active' | 'scheduled' | 'expired'

## Response `200`

Success

- ListCostCenterAllocationsResponse — Response listing the cost center allocations for an employment.
  - `data` object, required
    - `cost_center_allocations` CostCenterAllocation[], required
      - `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.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `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)