FAfactorialhr
Companies > LegalEntity

Reads all Legal entities

Changed on

Reads all Legal entities

get/api/2026-10-01/resources/companies/legal_entities

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/companies/legal_entities
  • 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

Query parameters

ids[]string[]

Return only the legal entities with these ids.

[
  "754",
  "98"
]
employees_ids[]string[]

identifier of the employees asigned to the legal entity

[
  "1",
  "2",
  "3"
]
companies_ids[]string[]

identifier of the companies to which the legal entity belongs

[
  "1"
]
country_ids[]string[]

country code of the legal entity

[
  "es"
]

Response

OK

Example response

{
  "data": [
    {
      "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