REST API endpoint for knock history and lead statuses

Every time a rep updates a prospect’s status in the field, LeadScout records a “knock” — a status-change event that captures which rep made the change, which status they set, and when. The knocks endpoint returns this complete event log alongside your company’s configured lead statuses so you can build activity reports, performance dashboards, and funnel analytics without additional lookups.

Sales reps without the canViewAllProspects permission see only knocks for prospects assigned to them. Admins and owners see all knocks across the company.

List knocks and statuses

GET /api/knocks

Returns all knock events and the full lead status configuration in a single response.

Response

object[]

Array of knock (status-change) events, ordered by createdAt ascending.

Show knock object

number

Knock event ID.

number

ID of the prospect this knock belongs to.

number

ID of the user who recorded the knock.

number

ID of the status that was set.

string

ISO 8601 timestamp when the knock was recorded.

object

Show addedBy

number

User ID.

string

First name.

string

Last name.

object

Show leadStatus

number

Status ID.

string

Status display label (e.g. "Contacted", "Not Home").

string

Hex color code used for map pins and UI badges.

object[]

Your company’s full lead status configuration, ordered by order ascending.

Show status object

number

Status ID.

string

Display label.

string

Hex color code.

number

Sort position in the status list.

curl --request GET \
  --url https://app.leadscoutapp.com/api/knocks \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const response = await fetch('https://app.leadscoutapp.com/api/knocks', {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const { knocks, statuses } = await response.json();

To count total knocks per rep, group the knocks array by addedByUserId. To build a status funnel, group by leadStatusId and join against the statuses array using the matching id.

Overview

Endpoints

REST API endpoint for knock history and lead statuses

List knocks and statuses

Response

​List knocks and statuses

​Response

List knocks and statuses

Response