Companies
Legal Entities

Update Legal Entity Administrative details

Update administrative details of legal entity 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

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage companies (company_management)-Manage companies (company:write)
put/v1/companies/{company_id}/legal-entities/{legal_entity_id}/administrative-details

Request

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

Path parameters

company_idstring uuid required

A unique identifier in UUID v4 format.

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

Company ID

legal_entity_idstring uuid required

A unique identifier in UUID v4 format.

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

Legal entity ID

Request body

administrative_detailsobject required

Administrative information. As its properties may vary depending on the country, you must query the Show legal entity administrative details form schema endpoint passing the country code and administrative_details as path parameters.

product_type'peo' | 'global_payroll' | 'e2e_payroll' required

Example request

{
  "administrative_details": {
    "company_industry": "Information Technology",
    "entity_type": "c_corp",
    "mailing_address_same_as_filing": "yes",
    "naics_code": "12345",
    "sic_code": [
      "12345"
    ],
    "state_tax_account_details": [
      {
        "state": "AK",
        "tax_account_number": "12345",
        "tax_rate": 5
      },
      {
        "state": "MD",
        "tax_account_number": "54321",
        "tax_rate": 50
      }
    ],
    "tax_classification": "corp"
  },
  "product_type": "peo"
}

Response

Success

dataobject required

Example response

{
  "data": {
    "legal_entity_state": "new",
    "trade_sector": "test sector"
  }
}

Changes

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