Get a custom list

1 import requests 2 3 url = "https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab" 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 "_id": "64f8b12345678901234567ab", 6 "account_id": "642be969c2186cae012347b8", 7 "name": "Suspicious Users Blocklist", 8 "status": "active", 9 "created_by": "admin@humansecurity.com", 10 "created_at": "2023-09-01T10:00:00Z", 11 "updated_at": "2023-09-01T15:30:00Z", 12 "updated_by": "admin@humansecurity.com", 13 "size": 150, 14 "description": "List of users flagged for suspicious activity", 15 "usedBy": [ 16 { 17 "rule_id": "d668491a-f8f8-4b92-a280-c437b4411e0e", 18 "name": "Blocklist Rule", 19 "status": "active" 20 } 21 ], 22 "last_inserted_time": "2023-09-01T14:00:00Z" 23 } 24 }

Retrieve the details of a custom list by its ID.

Path parameters

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

The unique identifier of the custom list

Response

Successfully retrieved custom list

messagestring

Response message

resultboolean

Indicates if the request was successful

contentobject or null

Path parameters

Headers

Response

Errors