List company structure nodes

Shows all the company structure nodes of an employment.

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

Category	Read only Scope	Write only Scope (read access implicit)
Manage company resources (company_admin)	View company structure (company_structure:read)	-

get/v1/employments/{employment_id}/company-structure-nodes

Request

Base URL: https://gateway.remote.com
URL: https://gateway.remote.com/v1/employments/{employment_id}/company-structure-nodes
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, company_structure:read, company_admin, all:write, all:read)

Path parameters

employment_idstring required

Employment ID

Response

Success

Example response

{
  "data": {
    "company_structure_nodes": [
      {
        "company_structure": {
          "attributes": {
            "type": "Cost Center"
          },
          "id": "dc022a60-16d0-46c8-8f57-276243168d78",
          "name": "Cost Center"
        },
        "id": "aa9a1cb4-d08d-47d3-82d3-7b90c95ff830",
        "parent": {
          "id": "96f9fb1f-fdae-4d0f-8931-5e168ab9c7fa",
          "name": "BCA Logistics"
        }
      },
      {
        "company_structure": {
          "id": "0162fe80-2fa4-4b2c-87be-6c6a208a9438",
          "name": "Supervisory Org"
        },
        "id": "13d00efe-50b5-466f-b86a-82a685336861",
        "parent": {
          "attributes": {
            "type": "Supervisory Org"
          },
          "id": "7e1dcfd8-8d3a-4aff-b2b7-23eabf88d844",
          "name": "Tokyo"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 65 revisions of this API.