Buyer Leads, Stats, and Export Examples
List delivered leads
GET /api/v1/buyer/leads?page=1&pageSize=25&status=Confirmed&from=2026-01-01&to=2026-01-31
Authorization: Bearer YOUR_ACCESS_TOKEN
Example response:
{
"page": 1,
"pageSize": 25,
"total": 120,
"totalPages": 5,
"data": [
{
"deliveryId": "recDelivery123",
"deliveryRef": "DEL-123",
"eventType": "Lead Sale",
"status": "Confirmed",
"payout": 100,
"deliveredAt": "2026-01-01T12:00:00Z",
"returned": false,
"lead": {
"fullName": "Jane Example",
"email": "jane@example.com",
"phone": "+15555550123",
"state": "FL",
"debtAmount": 100000,
"tcpaConsent": true,
"consentTimestamp": "2026-01-01T11:59:00Z",
"leadIp": "203.0.113.10",
"utmSource": "approved-campaign",
"sourceUrl": "https://example.com/form"
}
}
]
}
Stats endpoint
GET /api/v1/buyer/stats?days=30
Authorization: Bearer YOUR_ACCESS_TOKEN
The stats response includes:
Delivery totals.
Confirmed, pending, failed, and returned counts.
Confirmed, pending, and returned revenue.
Deliveries by event type.
Deliveries by day.
Pacing.
Offer cap and status data.
CSV export
Use:
GET /api/v1/buyer/export
Authorization: Bearer YOUR_ACCESS_TOKEN
The CSV export includes delivery fields plus TCPA consent, consent timestamp, consent version, lead IP, UTM fields, and source URL when available.