OpenapiV1Leads
List leads
Retrieve a paginated list of leads for your organization.
Use Cases:
- Display leads in external CRM dashboards
- Track lead attribution for commission platforms
- Export lead data for analytics
Filtering:
- Filter by status, source, assigned user
- Results are automatically scoped to your organization
Pagination:
- Cursor-based pagination (use
cursorfrom previous response) - Default limit: 50, max: 100
Query Parameters
limit?string
Number of results per page (max 100)
Default
"50"cursor?string
Cursor for pagination (opaque string)
status?string
Filter by lead status
source?string
Filter by lead source
assigned_to_id?string
Filter by assigned user ID (Clerk user ID)
Match
^user_[A-Za-z0-9]+$Response Body
application/json
application/json
application/json
curl -X GET "https://api.aura-app.ai/v1/leads"{
"data": [
{
"company": "Acme Corp",
"created_at": "2026-01-17T08:00:00Z",
"disqualification_data": {
"booking_link_id": "string",
"evaluated_at": "string",
"triggering_field": {
"key": "string",
"label": "string",
"value": null
},
"property1": null,
"property2": null
},
"email": "john@example.com",
"full_name": "John Doe",
"id": "550e8400-e29b-41d4-a716-446655440000",
"last_payment_at": "string",
"metadata": {
"city": "string",
"country": "string",
"countryCode": "US",
"dataConsentAcceptedAt": "2026-05-08T14:23:11.000Z",
"dclid": "string",
"epik": "string",
"fbclid": "string",
"gadSource": "string",
"gbraid": "string",
"gclid": "string",
"gclsrc": "string",
"hyclid": "string",
"ipAddress": "string",
"language": "en-US",
"latitude": 0,
"liFatId": "string",
"longitude": 0,
"msclkid": "string",
"partner": "string",
"rdtCid": "string",
"ref": "string",
"referrer": "https://acme.com/book-a-call",
"region": "string",
"scCid": "string",
"screenHeight": 0,
"screenWidth": 0,
"setterCode": "string",
"ttclid": "string",
"twclid": "string",
"userAgent": "string",
"utmCampaign": "spring-2026",
"utmContent": "string",
"utmId": "string",
"utmMedium": "cpc",
"utmSource": "google",
"utmTerm": "string",
"wbraid": "string",
"yclid": "string",
"property1": null,
"property2": null
},
"notes": [
{
"content": "string",
"created_at": "2026-05-08T14:23:11.000Z",
"user_id": "string",
"property1": null,
"property2": null
}
],
"payment_count": 0,
"payment_status": "string",
"phone": "+14155552671",
"source": {
"referrer": "https://acme.com/book-a-call",
"utm_campaign": "summer_promo",
"utm_content": "string",
"utm_medium": "cpc",
"utm_source": "google",
"utm_term": "string"
},
"status": "new",
"timezone": "America/New_York",
"total_paid_cents": 0,
"updated_at": "2026-01-17T09:30:00Z"
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJpZCI6IjQ1NiJ9"
}
}{
"code": "NOT_FOUND",
"error": "Lead not found",
"requestId": "req_abc123",
"success": false
}{
"code": "NOT_FOUND",
"error": "Lead not found",
"requestId": "req_abc123",
"success": false
}