---
title: "Get Entities"
method: GET
path: "/api/v2/entities/"
tags: ["Entities"]
---

# Get Entities

`GET /api/v2/entities/`

Get a list of direct `Entities` your organization manages. These `Entities` represent individual customers of your organization.

## Query parameters

- `reference_id` string, nullable
- `limit` integer
- `order` 'asc' | 'desc'
- `next` string, nullable
- `previous` string, nullable

## Response `200`

OK

- PaginatedEntityResponse
  - `_sv` 'PaginatedEntityResponse:v1' — Version
  - `data` Entity[], required — List of Entity
    - `id` string, uuid, required — Unique ID of the `Entity`.
    - `is_kyc_complete` boolean, required — Indicates if `Entity` completed KYC.
    - `entity_type` 'INDIVIDUAL' | 'ORGANIZATION', required
    - `name` string, nullable — Name of `Entity`.
    - `nationality` string, nullable — Nationality or home country of the `Entity`.
    - `reference_id` string, nullable — Case sensitive unique reference ID that you can set for the `Entity`. We recommend setting this to the unique ID of the `Entity` in your system.
  - `pagination_metadata` BaseOpenApiPaginationMetadata, required
    - `previous` string — Cursor for previous page
    - `next` string — Cursor for next page

## Other responses

- `422` — Unprocessable Entity
- `default` — Default error response

## Changes

- **2026-06-18** `142af68e5d3c` — 1 breaking, 2 warning, 4 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `page_size`
  - removed `#/components/schemas/PaginatedEntityResponse, subschema #1` from the response body `oneOf` list for the response status `200`
  - …3 more

[Change history](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api/changes/api/v2/entities/get.md)

---

[API](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api.md) · [All operations](https://skmtc.dev/dinaricrypto/apis/dinari-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dinaricrypto/dinari-enterprise-api/revisions/5403e9118588/schema)