Skip to main content

DocsREST API and MCP server

Saved Lists API

Endpoints, auth and live samples for Audience Builder, Connect Data and CRM sync.

Base URLhttps://us-farmvision-new-api.onrender.com

Connect Data: Saved Lists

List Saved Lists

Your 200 most recent prospect lists, newest first. Each records the run and pass (mode) it was filed from.

GEThttps://us-farmvision-new-api.onrender.com/api/v1/lead-generation/saved-listsTry it

In this section

Authentication

Get API key

Bearer token

Send your GTM Scoop API key (llmcp_…) or a signed-in session token as a Bearer token.

Authorization: Bearer YOUR_API_KEY

Parameters

This endpoint takes no parameters or request body.

Mounted at

/api/v1/lead-generation

Prospect lists filed from a run's AI analysis results. A list is a live view of its run (re-running the analysis changes it, and rows are trimmed to your plan's tier like run results); business AI analyses file one automatically when they finish, and Save Run as List files one under your own name.

Try it in the playground

Signed out: 10 free tries a day with names hidden. Log in for live data.

Open playground

Related endpoints

All 7 endpoints in this section

Bearer token: an llmcp_ API key or a signed-in session token.

MethodPathWhat it does
GET/api/v1/lead-generation/saved-lists

List Saved Lists

Your 200 most recent prospect lists, newest first. Each records the run and pass (mode) it was filed from.

Try List Saved Lists in the Playground
DELETE/api/v1/lead-generation/saved-lists

Delete All Saved Lists

Deletes every prospect list on your account and returns how many were removed. Only the lists go; the runs and results behind them are kept. Needs a signed-in web-app session: an API key or a connected AI app gets 403, so a leaked key can't wipe your lists (deleting one list by id still works with a key).

GET/api/v1/lead-generation/saved-lists/verdicts

List Verdict Records

Every record you have liked (or disliked) across all your runs, newest verdict first (up to 2,000), each resolved to the company it was about. Verdicts whose run or row no longer resolves are left out.

1 parameter
  • sentiment (string) "dislike" for dislikes; anything else, or nothing, returns likes.
Try List Verdict Records in the Playground
GET/api/v1/lead-generation/saved-lists/:id

Get Saved List

One list with its rows (read live from its run), column definitions, and your verdicts and dislike reasons keyed by rowIndex. An AI list holds only matched rows; a list whose run no longer has results opens with no rows. 404 if the list is not yours or does not exist.

1 parameter
  • id (string, required) The list's id (a UUID).
Try Get Saved List in the Playground
GET/api/v1/lead-generation/saved-lists/:id/records/:rowIndex

Get Saved List Record

One record of a list with the list's columns, your verdict and reason, and for an AI list the matched company's detail profile in business (null when there is none). 400 if rowIndex is not a non-negative integer; 404 if the list or row does not exist.

2 parameters
  • id (string, required) The list's id (a UUID).
  • rowIndex (integer, required) The row's rowIndex in the list, 0 or more.
Try Get Saved List Record in the Playground
DELETE/api/v1/lead-generation/saved-lists/:id

Delete Saved List

Deletes one prospect list; the run and its results are kept. 404 if the list is not yours or does not exist.

1 parameter
  • id (string, required) The list's id (a UUID).
POST/api/v1/lead-generation/runs/:runId/save-list

Save Run as List

Files a run's AI analysis results as a new prospect list under your own name; every call creates another list. An AI list keeps only matched rows (skippedCount says how many were left out). 404 if the run has no results for that mode yet; 400 if there is nothing to save.

4 parameters
  • runId (string, required) The run's id (a UUID).
  • mode (string, required) "ai" (or the legacy "data"). Anything else is a 400.
  • name (string, required) List name; trimmed, must not be blank, at most 200 characters (longer is a 400).
  • description (string) Free text shown with the list, at most 2,000 characters (longer is a 400).

Cookies on GTM Scoop

Essential cookies keep you signed in and the site secure, and are always on. Optional cookies (Google Analytics) help us understand how the site is used. They are on by default, except in the EU/EEA, the UK and Switzerland, where they stay off until you choose Accept All Cookies; choose Essential Cookies Only to turn them off. We do not use advertising cookies and we do not sell or share your personal information. The site works the same whichever you choose. We keep a record of your choice with the date, your IP address and the page you were on. Cookie Policy · Privacy Policy