Get custom lists

Retrieve all custom lists for the authenticated account with optional search functionality.

The search parameter filters lists by finding those that contain identifiers with values matching the search term (case-insensitive). It does not search by list names or descriptions.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

searchstringOptional

Search term to filter custom lists by their identifier values. This searches within the actual values of identifiers stored in the lists, not the list names or descriptions.

Example: Searching for “192.168” will return lists containing identifiers with values like “192.168.1.100”, “192.168.0.1”, etc.

Response

Successfully retrieved custom lists
messagestring
Response message
resultboolean
Indicates if the request was successful
contentlist of objects or null

Errors