What this endpoint does

This operation searches for Recorded Future lists matching optional filter criteria, returning metadata for each matching list. You can filter by list name (substring match), by list type (such as entity, source, ip, domain, company, vulnerability, and other specialized types), and control the number of results with a limit parameter (default 25, maximum 100). Submitting an empty request body returns all accessible lists up to the default limit. This is the primary way to discover list IDs needed by other Lists API endpoints such as Lists: Get Entities, Lists: Add Entity, Lists: Get Info, and Lists: Get Status.

Response data

The response is a JSON array of list metadata objects, each containing the list id (needed as a path parameter for all other list operations), name, type, created and updated timestamps, and ownership details including owner name, organization, and enterprise hierarchy.

There is no pagination — the response is a bare JSON array with no total count, offset, or cursor. The array contains up to limit results (maximum 100). If you have more lists than the limit, there is no built-in mechanism to retrieve results beyond the first page.

The organisation_id and organisation_name fields are optional and only appear when the list owner belongs to an organization. Lists owned by users without an organization will omit these fields.

200Success

400Bad query