---
title: "List entities"
method: GET
path: "/financial-data/v2/entities"
tags: ["Entities"]
---

# List entities

`GET /financial-data/v2/entities`

Returns a list of entities. For further details on Pagination, see general section above.

## Query parameters

- `limit` integer
- `token` string

## Response `200`

List of entities.

- object
  - `items` Entity[], required — A list of resources.
    - `id` string, required — Unique resource identifier.
    - `organizationId` string, required — Unique resource identifier for an Organization.
    - `parentId` string — This optional field identifies a parent entity, indicating this entity is a subsidiary or branch to the parent. A missing Parent Entity ID implies the entity is without parent company.
    - `legalName` string, required — Legal name of the entity. E.g. your company's legal business name.
    - `nationalIdentifier` NationalIdentifier
      - `type` 'CIVIC' | 'COMPANY', required — Type of the national identifier.
      - `market` string, required — Two-letter ISO 3166-1 alpha2 country code.
      - `number` string, required — The identifier itself.
    - `address` Address — Postal address.
      - `country` string — Two-letter ISO 3166-1 alpha2 country code.
      - `countrySubdivision` string — Country subdivision code (second part of the ISO 3166-2 code). E.g. state code `CA` for the state of California in the USA, `ON` for the province of Ontario in Canada, `NSW` for the state of New South Wales in Australia. ISO 3166-2 codes can be found on the ISO website, for example, for the USA: https://www.iso.org/obp/ui/#iso:code:3166:US. In the USA the state code is required for domestic payments, in Canada the province code is required for domestic payments.
      - `city` string
      - `postalCode` string
      - `streetName` string
      - `streetNumber` string
    - `created` string, date-time, required — Time at which the resource was created.
    - `updated` string, date-time, required — Time at which the resource was last updated.
    - `version` integer, required — Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.
  - `nextToken` string, required — Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched.
  - `token` string, required — The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request.
  - `limit` integer, required — The page limit that was used for this request.

## Other responses

- `400` — Bad request.

---

[API](https://skmtc.net/atlar/apis/atlar-api-v2.md) · [All operations](https://skmtc.net/atlar/apis/atlar-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlar/atlar-api-v2/revisions/9c5e194ccf5d/schema)