List your lists
Returns the contact lists of the account (top-level lists only: lists attached to a parent list are not returned).
Pagination is opt-in. Send page and/or limit to get the paginated envelope { items, total, page, pageSize, totalLeads }. Without both parameters the endpoint returns a bare JSON array with ALL your lists, unpaginated, newest first, and every filter parameter is ignored. Integrations should always send page and limit.
To find which lists contain a person, pass leadSearch with a full email address (case-insensitive match) or a LinkedIn profile URL (matched on the profile handle, so trailing slashes and www do not matter). Any other value returns zero lists.
Each item is the stored list document. Besides the documented fields it can contain internal fields (column preferences, AI action settings, CRM integration settings, linked lists): do not rely on them.
Authorization
apiKey Your 48 character API key, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api.
In: header
Query Parameters
Page number, starting at 1. Sending it switches the response to the paginated envelope.
1 <= value1Page size. Values above 100 are clamped to 100. Sending it switches the response to the paginated envelope.
1 <= value <= 10025Case-insensitive substring of the list name. Paginated mode only.
Full email address or LinkedIn profile URL: only the lists containing this contact are returned. Paginated mode only.
Import source, exact value, case-insensitive. Values written by the service: API (created through this API), Manual (empty list created in the app), CSV (file import), Sales Navigator (LinkedIn scrap), HubSpot, Pipedrive, Filter (list created from a filtered selection). Paginated mode only.
List status. Paginated mode only.
Value in
- "mapped"
- "pending mapping"
Sort field: leads, emails and phones sort on the counters. Unknown values fall back to createdAt. Paginated mode only.
"createdAt"Value in
- "name"
- "leads"
- "emails"
- "phones"
- "createdAt"
Sort direction. Any value other than asc sorts descending.
"desc"Value in
- "asc"
- "desc"
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/lists/list" \ -H "Authorization: YOUR_API_KEY"{ "items": [ { "_id": "66f1c0ffee5a7d3b2c4e8a10", "userId": "65a9b8c7d6e5f4a3b2c1d0e9", "name": "Acme prospects Q4", "source": "API", "status": "mapped", "companiesOnly": false, "numberOfContacts": 42, "numberOfEmails": 40, "numberOfPhones": 12, "numberOfLinkedins": 38, "emailFindRunAt": null, "phoneFindRunAt": null, "tagIds": [], "parentListId": null, "linkedLists": [], "createdAt": "2026-10-01T09:12:44.000Z", "updatedAt": "2026-10-03T16:40:02.000Z" } ], "total": 1, "page": 1, "pageSize": 25, "totalLeads": 42}