# List legal entities

This endpoint lists legal entities of a company. If externalId is provided in the query param 
only the legal entity having the provided externalId is returned.

Endpoint: GET /v2/companies/{companyId}/legal-entities
Version: v2
Security: Bearer

## Path parameters:

  - `companyId` (string, required)
    Identifier for company.
    Example: "4974a66b-7493-4f41-908c-58ba81093947"

## Query parameters:

  - `pageNumber` (integer)
    Page number to fetch for the query. Page number starts from 1.
    Example: 2

  - `pageSize` (integer)
    Page size to be to fetch for the query.
    Example: 20

  - `externalId` (string)
    External id of the entity.
    Example: "my-external-id"

## Response 200 fields (application/json):

  - `length` (integer)

  - `elements` (array)
    List of references containing id and name.

  - `elements.id` (string, required)
    Example: "b93dc51f-12dd-46c7-b7d6-1cb12cd3f5b3"

  - `elements.name` (string)
    Example: "Name"

  - `totalNumResults` (integer)
    Total number of results

## Response 401 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.

## Response 403 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.