v1

latestOpenAPI 3.1.02026-07-242735131.1 MB

Cost Center Allocations

List cost center allocations for an employment

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)

get/v1/employments/{employment_id}/cost-center-allocations

Path parameters

employment_idstring required

Employment ID

Query parameters

status'active' | 'scheduled' | 'expired'

Filters allocations by status. When omitted, allocations of every status are returned.

Response

Success

Example response

{
  "data": {
    "cost_center_allocations": [
      {
        "cost_center": {
          "code": "GTM-001",
          "name": "GTM - Sales",
          "slug": "93t3j-cost-center-id-9suej43"
        },
        "effective_from": "2026-01-01",
        "effective_to": null,
        "id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
        "percentage": 100,
        "status": "active"
      }
    ]
  }
}