Get custom list identifiers | HUMAN Documentation

1 curl https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab/identifiers \ 2 -H "Authorization: Bearer <token>"

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.

Authentication

AuthorizationBearer

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

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

Authentication

Path parameters

Query parameters

Response

Errors