Leads summary

The /reports/leads-summary endpoint returns lead and trial counts at different historical points (30, 60, 180, 365 days) with percentage changes, similar to the summary metrics endpoint but focused on leads and trials.

💡 Use case: Track lead generation growth over time. Monitor trial conversion trends. Build executive dashboards showing funnel performance.

GET /reports/leads-summary

Returns lead and trial snapshots at historical points with growth percentages.

Authentication

Required

Include your API key in the Authorization header:

curl https://api.growpanel.io/reports/leads-summary \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters

Parameter	Type	Description
`region`optional	string	Filter by region or country codes (space-separated). Example: `us ca`
`currency`optional	string	Filter by currency codes (space-separated).
`industry`optional	string	Filter by industry (space-separated).
`channel`optional	string	Filter by channel (space-separated).
`size`optional	string	Filter by customer size (space-separated).

Response

200 OK

Returns a summary object with lead and trial metrics over time.

{
  "summary": {
    "leads_30": 150,
    "leads_60": 140,
    "leads_180": 120,
    "leads_365": 90,
    "trials_30": 80,
    "trials_60": 75,
    "trials_180": 60,
    "trials_365": 45,
    "leads_percentage_change_30": 7.1,
    "leads_percentage_change_60": 14.3,
    "leads_percentage_change_180": 25.0,
    "leads_percentage_change_365": 66.7,
    "trials_percentage_change_30": 6.7,
    "trials_percentage_change_60": 13.3,
    "trials_percentage_change_180": 33.3,
    "trials_percentage_change_365": 77.8
  }
}

Response fields

Field	Type	Description
Lead Counts
`leads_30`	integer	New leads in the last 30 days
`leads_60`	integer	New leads in the last 60 days
`leads_180`	integer	New leads in the last 180 days
`leads_365`	integer	New leads in the last 365 days
Trial Counts
`trials_30`	integer	New trials in the last 30 days
`trials_60`	integer	New trials in the last 60 days
`trials_180`	integer	New trials in the last 180 days
`trials_365`	integer	New trials in the last 365 days
Percentage Changes
`leads_percentage_change_30`	float	Percentage change in leads vs prior 30-day period
`leads_percentage_change_60/180/365`	float	Percentage changes over 60, 180, and 365 day periods
`trials_percentage_change_30`	float	Percentage change in trials vs prior 30-day period
`trials_percentage_change_60/180/365`	float	Percentage changes over 60, 180, and 365 day periods

Example requests

Get overall leads summary

curl https://api.growpanel.io/reports/leads-summary \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by channel

curl "https://api.growpanel.io/reports/leads-summary?channel=organic" \
  -H "Authorization: Bearer YOUR_API_KEY"

Compare regions

curl "https://api.growpanel.io/reports/leads-summary?region=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by industry

curl "https://api.growpanel.io/reports/leads-summary?industry=saas" \
  -H "Authorization: Bearer YOUR_API_KEY"

Notes

Rolling periods: Each period represents a rolling window (e.g., leads_30 = leads from last 30 days)
Growth calculation: Percentage change compares current period to the equivalent prior period
Positive vs negative: Positive percentages indicate growth, negative indicate decline
Lead vs Trial: Leads are prospects, trials are active trial users
Filtering: All filter parameters work together (AND logic) to narrow down results

Lead Conversion Days - Conversion time distribution
Summary Metrics - MRR and customer snapshots