/list/{listId}/info

Returns metadata for a specific list including name, type, timestamps, and ownership details.

What this endpoint does

This operation retrieves metadata about a specific Recorded Future list, including its name, type, creation and last-updated timestamps, and ownership details. Use this endpoint to verify a list exists and check its properties before performing operations on it, or to look up ownership and organization information for a known list ID. For entity contents, use the Lists: Get Entities endpoint instead; for processing status information, use the Lists: Get Status endpoint. To find list IDs, use the Lists: Search endpoint.

Response data

The response contains the list's id, name, type (such as entity, source, or text), created and updated timestamps, and ownership fields including owner_id, owner_name, organisation_id, organisation_name, and a nested owner_organisation_details object with the full ownership and enterprise hierarchy. This endpoint does not return entity contents or entity count — use the Lists: Get Entities or Lists: Get Text Entries endpoints for list membership data.

Path Params
string
required

Unique identifier for a list (format: report:XXXXX) or a named watch list identifier, obtained from POST /list/search or POST /list/create.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json