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

# GET /list/{listId}/status

`GET /list/{listId}/status`

## Request

- Base URL: `https://api.recordedfuture.com`
- URL: `https://api.recordedfuture.com/list/{listId}/status`
- 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 the processing status and entity count for a specific list.

## Response `200`

Success

- object
  - `size` integer, required: Current number of entities in the list.
  - `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.

## 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)