---
title: "List intel entities"
description: "Lists ontology entities, including people, organizations, countries, CVEs, threat actors, vessels, aircraft, facilities, vendors, software, and protocols. `q` searches `canonicalName`. `kind` filters by exact kind."
canonical: https://y2.dev/docs/api/reference/intel/listEntitiesV2/
---

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

# List intel entities

Lists ontology entities, including people, organizations, countries, CVEs, threat actors, vessels, aircraft, facilities, vendors, software, and protocols. \`q\` searches \`canonicalName\`. \`kind\` filters by exact kind.

`GET https://api.y2.dev/api/v2/entities`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `fields[entities]` | query | string | No | Comma-separated allowlist of entity fields. Identity and links remain present. |
| `kind` | query | `person`, `organization`, `country`, `region`, `vessel`, `aircraft`, `facility`, `asset`, `indicator`, `cve`, `malware_family`, `threat_actor`, `vendor`, `software`, `ai_model`, `api_service`, `protocol` | No | Filter by entity kind |
| `q` | query | string | No | Full-text search across `canonicalName` (filtered by `kind` when present) |
| `limit` | query | integer | No | Maximum number of entities to return |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of intel entities | `EntityListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `PublicEntity` |  |
| `data[].cve` | `CVESummary` |  |
| `data[].source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].kind` | `EntityKind` |  |
| `data[].name` | string |  |
| `data[].aliases[]` | array of string |  |
| `data[].externalIds` | object |  |
| `data[].attributes` | object |  |
| `data[].footprint` | object |  |
| `data[].createdAt` | string (date-time) |  |
| `data[].updatedAt` | string (date-time) |  |
| `data[].links` | `PublicResourceLinks` |  |
| `meta` | `PublicListMeta` |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
