Get custom list identifiers

1 import requests 2 3 url = "https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab/identifiers" 4 5 headers = {"Authorization": "Bearer <token>"} 6 7 response = requests.get(url, headers=headers) 8 9 print(response.json())

1 { 2 "message": "success", 3 "result": true, 4 "content": { 5 "identifiers": [ 6 { 7 "_id": "64f8b12345678901234567cd", 8 "list_id": "64f8b12345678901234567ab", 9 "identifier": "socketIps", 10 "value": "user@example.com", 11 "created_by": "admin@humansecurity.com", 12 "created_at": "2023-09-01T12:00:00Z", 13 "updated_by": "admin@humansecurity.com", 14 "updated_at": "2023-09-01T12:00:00Z", 15 "creation_type": "manual" 16 } 17 ], 18 "pagination": { 19 "total": 150, 20 "totalFiltered": 150, 21 "limit": 50, 22 "offset": 0 23 } 24 } 25 }

Retrieve identifiers from a custom list.

Path parameters

listIdstringRequiredformat: "^[0-9a-fA-F]{24}$"

The unique identifier of the custom list

Query parameters

searchstringOptional

Search term for filtering identifiers by their values (not identifier types). Searches within the actual identifier values.

sortFieldenumOptional

Field to sort by

Allowed values:

sortDirectionenumOptional

Sort direction

Allowed values:

limitintegerOptional>=0

Maximum number of results to return

offsetintegerOptional>=0

Number of results to skip

filtersstringOptional

JSON object for complex filtering

Response

Successfully retrieved identifiers

messagestring

Response message

resultboolean

Indicates if the request was successful

contentobject or null

Path parameters

Headers

Query parameters

Response

Errors