Lists and saved searches
Create a list, add records to it, archive it, and save a search, with the request and reply for each.
Lists and saved searches live under /market/account. Nothing here deletes: archiving hides, and the same name brings an archived list back.
| Method and path | What it does |
|---|---|
GET /market/account/lists |
Your lists. Add ?include_archived=1 to include archived ones |
POST /market/account/lists |
Create a list |
GET /market/account/lists/{id} |
One list with up to 300 masked records |
POST /market/account/lists/{id}/add |
Add records |
POST /market/account/lists/{id}/archive |
Archive, or restore with {"archived": false} |
DELETE /market/account/lists/{id} |
Same as archive |
GET /market/account/searches |
Saved searches |
POST /market/account/searches |
Save a search |
DELETE /market/account/searches/{id} |
Archives the search |
Create and fill a list
POST /market/account/lists
{"name": "Sheffield accountants", "campaign": ""}
{"id": "6650f0c2a1b2c3d4e5f60999", "name": "Sheffield accountants", "count": 0, "campaign": "", "created_at": "2026-10-10T09:00:00Z"}
A name up to 80 characters. If a list with that name exists it is returned, and if it was archived it comes back.
POST /market/account/lists/6650f0c2a1b2c3d4e5f60999/add
{"lead_ids": ["mkt_sample0001", "mkt_sample0002"]}
{"ok": true, "count": 2}
Up to 500 ids per call. Ids already in the list are not added twice. An empty list of ids gives 400 no leads, and an unknown list 404 list not found.
Save a search
POST /market/account/searches
{"name": "New accountants", "params": {"category": "accountants", "area": "Sheffield", "recently_incorporated": 1}}
Only the filter names the route allows are kept. Others are dropped without an error. Saving does not run the search.