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. The array contains up to limit results with no pagination or total count metadata.