REremote-com
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.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.

Scopes

Any one of the scopes in a token type's row is enough. all:read and all:write work too.

Token typeCategoryRead only ScopeWrite only Scope (read access implicit)
Company-scoped access tokenManage employments (employments)View employments (employment:read)Manage employments (employment:write)
Company-scoped access token (assertion)Manage employments (employments)View employments (employment:read)Manage employments (employment:write)
Customer API tokenManage 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
    • OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: https://gateway.remote.com/company.manage
    • or OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: employment:read
    • or OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: all:read
    • or OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token scopes: all:write
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token scopes: employment:read
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token scopes: all:read
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token scopes: all:write
    • or HTTP bearer

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

No recorded changes to this operation across all 1 revision of this API.