Skip to main content
GET
/
api
/
agent
/
lists
Contact Lists
curl --request GET \
  --url https://encrata.com/api/agent/lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "emails": [
    "<string>"
  ],
  "targets": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "name": "<string>",
  "list_type": "<string>",
  "email_count": 123,
  "created_at": "<string>",
  "updated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires an API key in the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
List all lists

GET /api/agent/lists
​
type
string
Filter lists by type. Valid values: email, phone, domain, ip, company, darkweb.If omitted, returns all lists regardless of type.

​
Example request

curl "https://encrata.com/api/agent/lists?type=domain" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

Returns an array of list objects. 
[
  {
    "id": "d4e5f6a7-...",
    "name": "Priority Domains",
    "list_type": "domain",
    "email_count": 15,
    "created_at": "2026-05-01T10:00:00Z",
    "updated_at": "2026-05-10T14:30:00Z"
  }
]
​
id
string
Unique list identifier (UUID).
​
name
string
The list’s display name.
​
list_type
string
The type of targets in this list: email, phone, domain, ip, company, or darkweb.
​
email_count
number
Number of targets in the list.
​
created_at
string
ISO 8601 timestamp.
​
updated_at
string
ISO 8601 timestamp of last modification.

​
Create a list

POST /api/agent/lists
​
name
string
required
A display name for the list.
​
type
string
The type of targets. Default: email. Valid values: email, phone, domain, ip, company, darkweb.
​
emails
string[]
Initial targets to add (legacy field, works for all types).
​
targets
string[]
Initial targets to add.

​
Example request

curl -X POST https://encrata.com/api/agent/lists \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "Competitor Domains",
    "type": "domain",
    "targets": ["competitor1.com", "competitor2.io", "rival.co"]
  }'

​
Response

Returns the created list object with status 201. 
{
  "id": "d4e5f6a7-...",
  "name": "Competitor Domains",
  "list_type": "domain",
  "email_count": 3,
  "created_at": "2026-05-15T10:00:00Z",
  "updated_at": "2026-05-15T10:00:00Z"
}

​
Get a list

GET /api/agent/lists/{id} Returns a single list by ID. 
curl https://encrata.com/api/agent/lists/d4e5f6a7-... \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Delete a list

DELETE /api/agent/lists/{id} Deletes a list and all its targets. Returns 204 No Content. 
curl -X DELETE https://encrata.com/api/agent/lists/d4e5f6a7-... \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Manage list targets

​
List targets

GET /api/agent/lists/{id}/emails Returns an array of target strings in the list. 
curl https://encrata.com/api/agent/lists/d4e5f6a7-.../emails \
  -H "Authorization: Bearer YOUR_API_KEY"

["competitor1.com", "competitor2.io", "rival.co"]

​
Add targets

POST /api/agent/lists/{id}/emails
​
emails
string[]
required
Targets to add. Duplicates are ignored.
curl -X POST https://encrata.com/api/agent/lists/d4e5f6a7-.../emails \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"emails": ["newdomain.com"]}'

​
Remove targets

DELETE /api/agent/lists/{id}/emails
​
emails
string[]
required
Targets to remove from the list.
curl -X DELETE https://encrata.com/api/agent/lists/d4e5f6a7-.../emails \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"emails": ["competitor2.io"]}'