List lead lists
curl --request GET \
--url https://app.loice.ai/api/v1/lead-lists \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.loice.ai/api/v1/lead-lists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://app.loice.ai/api/v1/lead-lists';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://app.loice.ai/api/v1/lead-lists"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "cmf3x0v2b0001abcd",
"name": "Fintech CFOs",
"description": "",
"owner": null,
"crmAutoSync": false,
"archived": false,
"createdAt": "2026-10-15T09:00:00.000Z",
"updatedAt": "2026-10-15T09:30:00.000Z",
"stats": {
"members": 42,
"withEmail": 30,
"verifiedEmail": 28,
"withMobile": 0,
"crmSynced": 0,
"crmFailed": 0
}
}
],
"meta": {
"page": 1,
"pageSize": 25,
"total": 1,
"pageCount": 1,
"crmConnected": false
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"retryAfterSeconds": 123
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"retryAfterSeconds": 123
}
}API Reference
List lead lists
Returns one page (25) of the workspace’s active lead lists, most recently changed first, each with its member, verified-email, mobile and CRM-sync counts.
Billing
Free — this endpoint does not consume points.
GET
/
api
/
v1
/
lead-lists
List lead lists
curl --request GET \
--url https://app.loice.ai/api/v1/lead-lists \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.loice.ai/api/v1/lead-lists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://app.loice.ai/api/v1/lead-lists';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://app.loice.ai/api/v1/lead-lists"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "cmf3x0v2b0001abcd",
"name": "Fintech CFOs",
"description": "",
"owner": null,
"crmAutoSync": false,
"archived": false,
"createdAt": "2026-10-15T09:00:00.000Z",
"updatedAt": "2026-10-15T09:30:00.000Z",
"stats": {
"members": 42,
"withEmail": 30,
"verifiedEmail": 28,
"withMobile": 0,
"crmSynced": 0,
"crmFailed": 0
}
}
],
"meta": {
"page": 1,
"pageSize": 25,
"total": 1,
"pageCount": 1,
"crmConnected": false
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"retryAfterSeconds": 123
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "<string>",
"retryAfterSeconds": 123
}
}Authorizations
Workspace API key (loice_sk_ + 48 hex characters), created under Settings → API Keys. Sent as Authorization: Bearer loice_sk_…. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.
Query Parameters
1-based page; 25 lists per page.
Required range:
1 <= x <= 100000Search by list name.
Maximum string length:
120
