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
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://api.aura-app.ai/v1/leads"{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"organization_id": "org_2abc123xyz",
"full_name": "John Doe",
"email": "john@example.com",
"phone": "+14155552671",
"company": "Acme Corp",
"status": "new",
"notes": null,
"metadata": null,
"timezone": "America/New_York",
"visitor_id": "string",
"automation_locked": true,
"automation_locked_at": "string",
"automation_locked_by": "string",
"disqualification_data": null,
"payment_status": "string",
"payment_count": 0,
"total_paid_cents": 0,
"last_payment_at": "string",
"created_at": "2026-01-17T08:00:00Z",
"updated_at": "2026-01-17T09:30:00Z"
}
],
"pagination": {
"next_cursor": "eyJpZCI6IjQ1NiJ9",
"has_more": true
}
}{
"success": false,
"error": "Lead not found",
"code": "NOT_FOUND",
"requestId": "req_abc123"
}{
"success": false,
"error": "Lead not found",
"code": "NOT_FOUND",
"requestId": "req_abc123"
}