---
title: "POST /list/search"
method: POST
path: "/list/search"
tags: ["List"]
---

# POST /list/search

`POST /list/search`

Searches for lists matching optional name, type, and limit filters.

## Request body

- object
  - `name` string — Substring match against list names.
  - `type` 'entity' | 'source' | 'text' | 'custom' | 'ip' | 'domain' | 'tech_stack' | 'industry' | 'brand' | 'partner' | 'industry_peer' | 'location' | 'supplier' | 'vulnerability' | 'company' | 'hash' | 'operation' | 'attacker' | 'target' | 'method' | 'executive'
  - `limit` integer

## Response `200`

Success

- ListInfo[]
  - `id` string, required
  - `name` string, required
  - `type` 'entity' | 'source' | 'text' | 'custom' | 'ip' | 'domain' | 'tech_stack' | 'industry' | 'brand' | 'partner' | 'industry_peer' | 'location' | 'supplier' | 'vulnerability' | 'company' | 'hash' | 'operation' | 'attacker' | 'target' | 'method' | 'executive', required
  - `created` string, date-time, required
  - `updated` string, date-time, required
  - `owner_id` string — Id of the Owner
  - `owner_name` string — Name of the Owner
  - `organisation_id` string — Id of the Organisation
  - `organisation_name` string — Name of the Organisation
  - `owner_organisation_details` OwnerOrganisationDetails
    - `owner_id` string — Id of the Owner
    - `owner_name` string — Name of the Owner
    - `organisations` Organisation[], required
      - `organisation_id` string — Id of the Organisation
      - `organisation_name` string — Name of the Organisation
    - `enterprise_id` string, required — Id of the Enterprise
    - `enterprise_name` string, required — Name of the Enterprise

## Other responses

- `400` — Bad query

---

[API](https://skmtc.net/recordedfuture/apis/alert-api.md) · [All operations](https://skmtc.net/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)