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.

200Success

400List is not migrated

404No such list