Employments
Cost Center Allocations

List cost center allocations for an employment

Changed on

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.

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/employments/{employment_id}/cost-center-allocations

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/employments/{employment_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

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"
      }
    ]
  }
}

Changes