Aggregate lead totals and breakdowns by stage and source

GET

/leads/summary

• Production

Returns flat totals (count, estimated_value_total) plus a breakdown by pipeline stage (with stage name joined from lead_stages) and a breakdown by source. Null source becomes its own bucket. Money values are decimal strings. Date filter applies to createdAt.

Authorizations

• bearerAuth
  leads:read

Parameters

Query Parameters

dateFrom

string format: date-time

dateTo

string format: date-time

assignedTo

integer

> 0

stageId

integer

> 0

Responses

200

Lead summary

object

data

required

object

totals

required

object

count

required

integer

estimated_value_total

required

string

by_stage

required

Array<object>

object

stageId

required

integer | null

stageName

required

string | null

count

required

integer

estimated_value_total

required

string

by_source

required

Array<object>

object

source

required

string | null

count

required

integer

estimated_value_total

required

string

meta

required

object

request_id

Server-generated request identifier

string

pagination

object

cursor

required

Opaque cursor for the next page; null when no more results

string | null

has_more

required

Whether more pages are available after this one

boolean

count

required

Items in this page

integer

403

Scope insufficient

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string

422

Validation failed

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string