FAfactorialhr
Companies > LegalEntity

Reads a single Legal entity

Changed on

Reads a single Legal entity

get/api/2026-10-01/resources/companies/legal_entities/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/companies/legal_entities/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: company_legal_entities
    • or API key in header x-api-key

Path parameters

idstring required

Return only the legal entities with these ids.

Response

OK

idstring required

identifier of the legal entity

company_idstring required

company identifier

countrystring required

Country code of the jurisdiction the legal entity is registered in (lowercase two-letter code, e.g. "es").

legal_namestring required

Legal name of the legal entity

currencystring required

The currency code in ISO 4217 format

tinstring

Tax identification number

siretstring

SIRET number (France-specific). System for identifying French establishments. 14-digit identifier for each French establishment.

citystring

City of the legal entity

statestring

State of the legal entity

postal_codestring

Postal code of the legal entity

address_line_1string

Address line 1 of the legal entity

address_line_2string

Address line 2 of the legal entity

Example response

{
  "id": "754",
  "company_id": "1",
  "country": "es",
  "legal_name": "Acme Inc.",
  "currency": "EUR",
  "tin": "H41192410",
  "siret": "12345678901234",
  "city": "Barcelona",
  "state": "Barcelona",
  "postal_code": "08005",
  "address_line_1": "Carrer Mallorca",
  "address_line_2": "61 2A"
}

Changes