Employments
Cost Center Allocations

List cost center allocations for a company

Changed on

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.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page. See Authorization for customers.

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

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/company/{company_id}/cost-center-allocations
  • Auth: HTTP bearer and OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, employment:read, employment:write, employments, all:write, all:read)

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
}

Changes