> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Lemlist: Get Watchlist History
> Get Signal Agent configuration history. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.
Get Signal Agent configuration history.
Tool ID: `lemlist_get_watchlist_history`
## Run this action
Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.
```ts theme={null}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'lemlist_get_watchlist_history',
{
"watchListId": "watch_list_123"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute lemlist_get_watchlist_history --input '{
"watchListId": "watch_list_123"
}' --json
```
## Example response
The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.
```json theme={null}
{
"data": {
"data": [
{
"_id": "_123",
"startDate": "2026-01-15T12:00:00Z",
"endDate": "2026-01-15T12:00:00Z"
}
],
"meta": {
"pagination": {
"page": 123,
"limit": 123,
"totalRecords": 123
}
}
}
}
```
Use `deepline tools get lemlist_get_watchlist_history --json` for the latest machine-readable contract.
## Input reference
Get Signal Agent configuration history
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.watchListId` | `string` | Yes | — | Signal Agent id whose history to fetch Minimum length: 1. |
| `payload.page` | `integer` | No | — | Page number to retrieve Minimum: 1. |
| `payload.limit` | `integer` | No | — | Number of records to retrieve. Maximum value: 100 Minimum: 1. Maximum: 100. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Get Signal Agent configuration history",
"properties": {
"watchListId": {
"type": "string",
"description": "Signal Agent id whose history to fetch",
"minLength": 1
},
"page": {
"type": "integer",
"description": "Page number to retrieve",
"minimum": 1
},
"limit": {
"type": "integer",
"description": "Number of records to retrieve. Maximum value: 100",
"minimum": 1,
"maximum": 100
}
},
"required": [
"watchListId"
],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[]._id` | `string` | No | — | History entry identifier |
| `result.data.data[].startDate` | `string` | No | — | When this configuration version became active Format: `date-time`. |
| `result.data.data[].endDate` | `string` | No | — | When this configuration version was replaced Format: `date-time`. |
| `result.data.data[].createdBy` | `string` | No | — | User id that made the change |
| `result.data.data[].name` | `string` | No | — | Signal Agent name at capture time |
| `result.data.data[].emoji` | `string` | No | — | Emoji at capture time |
| `result.data.data[].type` | `"companyIsHiring" \| "companyRaisedFunds" \| "recruitmentCampaign" \| "jobChange" \| "newHire" \| "companyEmployeeVisitedMyWebsite" \| "customSignals" \| "competitorConnections" \| "competitorReactions" \| "technologyChange" \| "linkedinPeopleProfile" \| "linkedinCompanyProfile" \| "mergersAcquisitions" \| "promotion" \| "linkedinKeywords" \| "republishedJobOffers" \| "externalSignalContact" \| "externalSignalCompany" \| "buyingIntent" \| "newProductLaunch" \| "companyAward" \| "newPartnership" \| "newOffice" \| "closingOffice" \| "costCutting" \| "outagesAndSecurityBreaches" \| "lawsuitsAndLegalIssues" \| "githubStargazer"` | No | — | Signal type Allowed: `companyIsHiring`, `companyRaisedFunds`, `recruitmentCampaign`, `jobChange`, `newHire`, `companyEmployeeVisitedMyWebsite`, `customSignals`, `competitorConnections`, `competitorReactions`, `technologyChange`, `linkedinPeopleProfile`, `linkedinCompanyProfile`, `mergersAcquisitions`, `promotion`, `linkedinKeywords`, `republishedJobOffers`, `externalSignalContact`, `externalSignalCompany`, `buyingIntent`, `newProductLaunch`, `companyAward`, `newPartnership`, `newOffice`, See the live schema for the complete constraint. |
| `result.data.data[].entity` | `"contact" \| "company"` | No | — | Entity kind Allowed: `contact`, `company`. |
| `result.data.data[].segmentType` | `"all" \| "list" \| "csv"` | No | — | Segment sourcing Allowed: `all`, `list`, `csv`. |
| `result.data.data[].filters` | `array` | No | — | — |
| `result.data.data[].filters[].filterId` | `"title" \| "description" \| "location" \| "visitLocation" \| "website" \| "pagesTracked" \| "minVisitDuration" \| "minPageViewed" \| "internalTraffic" \| "linkedinUrls" \| "companyLinkedinUrls" \| "companyNames" \| "companyLocation" \| "companyIndustries" \| "companySizes" \| "maxIdentificationsPerDay" \| "excludedVisitorIps" \| "reactionTypes" \| "linkedinTopics" \| "bomboraTopics" \| "watcherWatchKey" \| "questions" \| "fundraisingMinAmount" \| "fundraisingMaxAmount" \| "fundraisingInvestmentTypes" \| "fundraisingInvestors" \| "technologies" \| "detectionMode" \| "maDealTypes" \| "maMinAmount" \| "persona" \| "customPersonaTitles" \| "externalSignalFieldMapping" \| "externalSignalCustomFieldMapping" \| "seniority" \| "crmListIds" \| "minJobCount" \| "timeframe" \| "githubRepoUrls"` | Yes | — | Filter identifier Allowed: `title`, `description`, `location`, `visitLocation`, `website`, `pagesTracked`, `minVisitDuration`, `minPageViewed`, `internalTraffic`, `linkedinUrls`, `companyLinkedinUrls`, `companyNames`, `companyLocation`, `companyIndustries`, `companySizes`, `maxIdentificationsPerDay`, `excludedVisitorIps`, `reactionTypes`, `linkedinTopics`, `bomboraTopics`, `watcherWatchKey`, `questions`, `fundraisingMinAmount`, `fundraisingMaxAmount`, `fundraisingInvestmentTypes`, See the live schema for the complete constraint. |
| `result.data.data[].filters[].in` | `array` | No | — | Values to include |
| `result.data.data[].filters[].out` | `array` | No | — | Values to exclude |
| `result.data.data[].signalProcessingType` | `"manual" \| "create_opportunity" \| "push_to_campaign"` | No | — | Signal processing type Allowed: `manual`, `create_opportunity`, `push_to_campaign`. |
| `result.data.data[].stats` | `object` | No | — | Signal/campaign stats computed for the window \[startDate, endDate). |
| `result.data.data[].stats.signalsCount` | `integer` | No | — | Number of signals detected in the window |
| `result.data.data[].stats.campaigns` | `array` | No | — | Per-campaign breakdown (push\_to\_campaign agents only) |
| `result.data.meta` | `object` | No | — | — |
| `result.data.meta.pagination` | `object` | No | — | — |
| `result.data.meta.pagination.page` | `integer` | No | — | Current page number |
| `result.data.meta.pagination.limit` | `integer` | No | — | Number of records per page |
| `result.data.meta.pagination.totalRecords` | `integer` | No | — | Total records matching the filter |
| `result.data.meta.pagination.totalPages` | `integer` | No | — | Total number of pages |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"description": "A past configuration version of a Signal Agent, active during [startDate, endDate).",
"properties": {
"_id": {
"type": "string",
"description": "History entry identifier"
},
"startDate": {
"type": "string",
"description": "When this configuration version became active",
"format": "date-time"
},
"endDate": {
"type": "string",
"description": "When this configuration version was replaced",
"format": "date-time"
},
"createdBy": {
"type": "string",
"description": "User id that made the change"
},
"name": {
"type": "string",
"description": "Signal Agent name at capture time"
},
"emoji": {
"type": "string",
"description": "Emoji at capture time"
},
"type": {
"type": "string",
"description": "Signal type",
"enum": [
"companyIsHiring",
"companyRaisedFunds",
"recruitmentCampaign",
"jobChange",
"newHire",
"companyEmployeeVisitedMyWebsite",
"customSignals",
"competitorConnections",
"competitorReactions",
"technologyChange",
"linkedinPeopleProfile",
"linkedinCompanyProfile",
"mergersAcquisitions",
"promotion",
"linkedinKeywords",
"republishedJobOffers",
"externalSignalContact",
"externalSignalCompany",
"buyingIntent",
"newProductLaunch",
"companyAward",
"newPartnership",
"newOffice",
"closingOffice",
"costCutting",
"outagesAndSecurityBreaches",
"lawsuitsAndLegalIssues",
"githubStargazer"
]
},
"entity": {
"type": "string",
"description": "Entity kind",
"enum": [
"contact",
"company"
]
},
"segmentType": {
"type": "string",
"description": "Segment sourcing",
"enum": [
"all",
"list",
"csv"
]
},
"filters": {
"type": "array",
"items": {
"type": "object",
"description": "A filter narrowing which entities or events a Signal Agent tracks. `in` includes matching values, `out` excludes them.",
"properties": {
"filterId": {
"type": "string",
"description": "Filter identifier",
"enum": [
"title",
"description",
"location",
"visitLocation",
"website",
"pagesTracked",
"minVisitDuration",
"minPageViewed",
"internalTraffic",
"linkedinUrls",
"companyLinkedinUrls",
"companyNames",
"companyLocation",
"companyIndustries",
"companySizes",
"maxIdentificationsPerDay",
"excludedVisitorIps",
"reactionTypes",
"linkedinTopics",
"bomboraTopics",
"watcherWatchKey",
"questions",
"fundraisingMinAmount",
"fundraisingMaxAmount",
"fundraisingInvestmentTypes",
"fundraisingInvestors",
"technologies",
"detectionMode",
"maDealTypes",
"maMinAmount",
"persona",
"customPersonaTitles",
"externalSignalFieldMapping",
"externalSignalCustomFieldMapping",
"seniority",
"crmListIds",
"minJobCount",
"timeframe",
"githubRepoUrls"
]
},
"in": {
"type": "array",
"description": "Values to include",
"items": {
"type": "string"
}
},
"out": {
"type": "array",
"description": "Values to exclude",
"items": {
"type": "string"
}
}
},
"required": [
"filterId"
],
"additionalProperties": false
}
},
"signalProcessingType": {
"type": "string",
"description": "Signal processing type",
"enum": [
"manual",
"create_opportunity",
"push_to_campaign"
]
},
"stats": {
"type": "object",
"description": "Signal/campaign stats computed for the window [startDate, endDate).",
"properties": {
"signalsCount": {
"type": "integer",
"description": "Number of signals detected in the window"
},
"campaigns": {
"type": "array",
"description": "Per-campaign breakdown (push_to_campaign agents only)",
"items": {
"type": "object"
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Current page number"
},
"limit": {
"type": "integer",
"description": "Number of records per page"
},
"totalRecords": {
"type": "integer",
"description": "Total records matching the filter"
},
"totalPages": {
"type": "integer",
"description": "Total number of pages"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Deepline cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
## Related documentation
* [Lemlist provider guide](/docs/providers/lemlist/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.