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

# GET /list/{listId}/status

`GET /list/{listId}/status`

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/alert-api.md) · [All operations](https://skmtc.dev/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)