Aura Logo
AuraAPI Docs
OpenapiV1LeadsId

Get lead by ID

Retrieve detailed information about a specific lead.

Use Cases:

  • Display lead details in external applications
  • Fetch lead data for commission calculations
  • Verify lead ownership before processing

Response includes:

  • All lead fields (contact info, status, notes)
  • Timestamps (created, updated)
  • Custom fields
GET
/v1/leads/{id}

Path Parameters

idstring

Lead ID (UUID)

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://api.aura-app.ai/v1/leads/550e8400-e29b-41d4-a716-446655440000"
{
  "success": true,
  "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"
  }
}
{
  "success": false,
  "error": "Lead not found",
  "code": "NOT_FOUND",
  "requestId": "req_abc123"
}
{
  "success": false,
  "error": "Lead not found",
  "code": "NOT_FOUND",
  "requestId": "req_abc123"
}