Sign in

v1

latestOpenAPI 3.1.02026-07-242735131.1 MB
Cost Center Allocations

List cost center allocations for a company

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

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage employments (employments)View employments (employment:read)Manage employments (employment:write)
get/v1/company/{company_id}/cost-center-allocations

Path parameters

company_idstring required

Company ID

Query parameters

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

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

pageinteger

Starts fetching records after the given page

page_sizeinteger

Number of items per page

Response

Success

Example response

{
  "current_page": 1,
  "employments": [
    {
      "bill_to_legal_entity_id": "93t3j-bill-to-legal-entity-id-9suej43",
      "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"
        }
      ],
      "employment_id": "93t3j-employment-id-9suej43",
      "engaged_by_legal_entity_id": "93t3j-engaged-by-legal-entity-id-9suej43"
    }
  ],
  "total_count": 1,
  "total_pages": 1
}