List Company Legal Entities

Changed on Oct 7, 2026

Lists all active legal entities for the authorized company specified in the request.

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.
Client credentials access token (OAuth2ClientCredentials) — obtained through the Client Credentials flow or the Refresh Token flow. See Authentication for partners.

Scopes

Category	Read only Scope	Write only Scope (read access implicit)
Manage company resources (company_admin)	View companies (company:read)	Manage companies (company:write)

get/v1/companies/{company_id}/legal-entities

Request

Base URL: https://gateway.remote.com
URL: https://gateway.remote.com/v1/companies/{company_id}/legal-entities
Auth: OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, company:read, company:write, company_admin, all:write, all:read) and OAuth 2 (client credentials, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, company:read, company:write, company_admin, all:write, all:read)

Path parameters

company_idstring uuid required

A unique identifier in UUID v4 format.

Example:663e0b79-c893-45ff-a1b2-f6dcabc098b5

Company ID

Query parameters

pageinteger

Starts fetching records after the given page

page_sizeinteger

Number of items per page

Response

Success

Example response

{
  "current_page": 1,
  "legal_entities": [
    {
      "country_code": "USA",
      "global_payroll_enabled": true,
      "id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
      "is_default": false,
      "name": "Remote Inc"
    }
  ],
  "total_count": 1,
  "total_pages": 1
}

Changes

Oct 7, 202609a7e24e0df5 Revision changes
- info
  the security scope company_admin was added to the endpoint's security scheme OAuth2AuthorizationCode
- info
  the security scope company_admin was added to the endpoint's security scheme OAuth2ClientCredentials
- info
  the security scope company_management was removed from the endpoint's security scheme OAuth2AuthorizationCode
- info
  the security scope company_management was removed from the endpoint's security scheme OAuth2ClientCredentials
Oct 6, 20269410f5f18a91 Revision changes
- info
  the security scope company_management was added to the endpoint's security scheme OAuth2AuthorizationCode
- info
  the security scope company_management was added to the endpoint's security scheme OAuth2ClientCredentials
- info
  the security scope company_admin was removed from the endpoint's security scheme OAuth2AuthorizationCode
- info
  the security scope company_admin was removed from the endpoint's security scheme OAuth2ClientCredentials

Operation history