---
title: "GET /list/{listId}/entities"
method: GET
path: "/list/{listId}/entities"
tags: ["List"]
---

# GET /list/{listId}/entities

`GET /list/{listId}/entities`

## Request

- Base URL: `https://api.recordedfuture.com`
- URL: `https://api.recordedfuture.com/list/{listId}/entities`
- Auth: one of:
  - API key in header `X-RFToken`
  - OAuth 2
    - Authorization code: `https://id.recordedfuture.com/authorize`
    - Token URL: `https://id.recordedfuture.com/token`

Returns all entities in the specified list as a JSON array with no pagination.

## Response `200`

Success

- EntityEntry[]
  - `entity` ResolvedEntity, required
    - `id` string, required
    - `type` string, required
    - `name` string, required
  - `context` object: Optional metadata attached to this entity when it was added to the list. Contains arbitrary key-value pairs set by the caller via the Add Entity endpoint. Only present if context was provided when the entity was added.
  - `status` 'pending' | 'processing' | 'ready', required: `pending` — awaiting initial processing after being added; `processing` — currently being indexed; `ready` — fully processed and available for use in alerts and queries.
  - `added` string, date-time, required: Timestamp when the entity was added to the list

## Other responses

- `400`: List is not migrated
- `404`: No such list

---

[API](https://skmtc.dev/recordedfuture/apis/list-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/list-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/list-api/revisions/95042b3bf39c?raw)