---
title: "Get an intel entity"
description: "Returns an entity with inbound and outbound relations, related entities, participating incidents, subject markets, recent observations, and tenant-scoped company financial observations when requested."
canonical: https://y2.dev/docs/api/reference/intel/getEntityV2/
---

Endpoint Reference[Intel](https://y2.dev/docs/api/reference/intel)

# Get an intel entity

Returns an entity with inbound and outbound relations, related entities, participating incidents, subject markets, recent observations, and tenant-scoped company financial observations when requested.

`GET https://api.y2.dev/api/v2/entities/{entityId}`

- Operation ID: `getEntityV2`
- Required scopes: `intel:explorer`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `include` | query | string | No | Bounded related resources to embed: `relations`, `relatedEntities`, `incidents`, `markets`, `observations`, `companyIdentity`, or `financialObservations`. Financial observations require an authenticated tenant context and are never returned across tenants. |
| `fields[entities]` | query | string | No | Comma-separated allowlist of entity fields. Identity and links remain present. |
| `fields[incidents]` | query | string | No | Comma-separated allowlist of incident fields. Identity and links remain present. |
| `fields[markets]` | query | string | No | Comma-separated allowlist of market fields. Identity remains present. |
| `fields[observations]` | query | string | No | Comma-separated allowlist of observation fields. Identity and source links remain present. |
| `entityId` | path | string | Yes | Stable Y2 public entity ID (`ent_...`). Legacy IDs are accepted during migration. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Entity drill: entity, relations, incidents, markets | `EntityDetailResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 404 | Resource not found |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | `EntityDetail` |  |
| `data.entity` | `PublicEntity` |  |
| `data.fromRelations[]` | array of `PublicEntityRelation` |  |
| `data.toRelations[]` | array of `PublicEntityRelation` |  |
| `data.relatedEntities[]` | array of `PublicEntity` |  |
| `data.incidents[]` | array of `PublicIncident` |  |
| `data.markets[]` | array of `PublicMarket` |  |
| `data.observations[]` | array of `PublicObservation` |  |
| `data.companyIdentity` | `CompanyIdentityVerification` |  |
| `data.financialObservations[]` | array of `CompanyFinancialObservation` |  |
