Get lead
Get a single lead by ID, including its full event history.
Authorizations
Path Parameters
Response
The unique identifier of the lead
The name of the lead
"Jane Doe"
The LinkedIn profile URL of the lead
"https://www.linkedin.com/in/jane-doe"
Whether the lead has replied
Whether the lead has an unread reply
Whether the lead was skipped
When the lead was created
When the lead was last updated
Chronological event history for the lead
The lead's company
The lead's job title
The campaign this lead belongs to, if any
The list this lead belongs to, if any
The campaign's status when this lead was added to it. It is not updated as the lead moves through its sequence, so it does not show whether the lead's sequence is still running, has finished, failed or was stopped. For that, read the lead's events on GET /v1/leads/{id}: WORKFLOW_CLEANUP means the sequence finished, WORKFLOW_FAILED means it failed, and stoppedAt is set when it was stopped through the API.
Why the lead was skipped, if applicable
The lead's location
The most recent message in the conversation
Id of the lead’s standard LinkedIn conversation — the id that POST /v1/conversations/{id}/reply expects. Null until Botdog has linked one; POST /v1/messages does not need it, and records it on first use.
A free-text status note
Custom key-value attributes supplied when the lead was added
When the invite was sent
When the lead connected
When the lead replied
When the invitation was withdrawn
When the lead was stopped, if it was. This is the authoritative confirmation that a stop took effect: it is written only after the lead’s sequence has been torn down, so a non-null value means no further steps — including any message already waiting on a delay — can run. Poll this after DELETE /v1/leads/{id} rather than the stopped flag on the stop response.
The Botdog user whose LinkedIn account contacts this lead: for a team-campaign lead, the teammate it is assigned to; otherwise the lead’s owner. Null for a team-campaign lead no teammate has picked up yet.
"user_abc123"