---
title: "Get entity profile"
method: GET
path: "/v3/entities/{id}"
tags: ["Entities"]
---

# Get entity profile

`GET /v3/entities/{id}`

Reads one KYBed entity profile from the latest published label version by default. Explicit mutable-version reads require a platform-admin session or an entity-admin session for the same entity.

## Path parameters

- `id` string, required

## Query parameters

- `labelSet` string
- `version` string

## Response `200`

Entity profile.

- object
  - `data` Entity, required
    - `id` string, required — Stable lowercase slug identifier.
    - `name` string, required
    - `logo` union, required — Absolute HTTP(S) URL or a safe asset filename without path separators.
      - string, uri
      - string
    - `description` string, nullable, required
    - `url` string, uri, nullable, required
    - `socialTwitter` string, uri, nullable, required
    - `socialYoutube` string, uri, nullable, required
    - `socialDiscord` string, uri, nullable, required
    - `socialTelegram` string, uri, nullable, required
    - `socialGithub` string, uri, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `meta` PaginationMeta, required
    - `total` integer — Exact total count when the endpoint provides one.
    - `hasMore` boolean — Indicates whether another page exists beyond the current page.
    - `offset` integer
    - `limit` integer — Echoed page size after endpoint-side clamping.
    - `timestamp` string, date-time, required
    - `chainId` string — Comma-separated chain IDs for multi-chain responses.
    - `degradedProviders` string[] — Live providers whose data is incomplete in this response.

## Other responses

- `401` — Missing, invalid, or expired authenticated session.
- `403` — Authenticated session exists, but platform-admin access is not active.
- `404` — Entity profile was not found.
- `422` — Invalid entity id.

---

[API](https://skmtc.dev/euler/apis/euler-data-api-v3.md) · [All operations](https://skmtc.dev/euler/apis/euler-data-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/euler/euler-data-api-v3/revisions/9573a5fbd4a6/schema)
