Sign in

v1

latestOpenAPI 3.1.02026-07-242735131.1 MB
Legal Entities

Update Legal Entity Administrative details

Update administrative details of legal entity for the authorized company specified in the request.

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

Path parameters

company_idstring uuid required

Identifier of the employment being terminated.

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

Company ID

legal_entity_idstring uuid required

Identifier of the employment being terminated.

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