List opportunities

Retrieve a paginated list of opportunities (deals) for your organization, newest first.

Each opportunity is a booking call viewed as a deal, joined to its lead and any linked sale. The stage field is derived at read time from the lead's full call history using the same rules as the dashboard pipeline:

1. disqualified — latest form/intent disqualification (overridden by newer booking activity)
2. booked / confirmed — active future booking (confirmed when the guest accepted)
3. Most recent past outcome — won / unfit / lost / cancelled / declined / attended / no_show / follow_up
4. qualified / interested — qualification signals without a booking
5. Stored lead status fallback

Use Cases:

• Sync deals into an external CRM or reporting warehouse
• Track pipeline movement without polling individual leads
• Reconcile expected vs actual deal value

Filtering:

• Filter by derived stage, lead, or scheduled date range
• Stage filtering is applied per page (see the stage parameter)

curl -X GET "https://api.aura-app.ai/v1/opportunities"

{
  "data": [
    {
      "actual_value": 4500,
      "booking_link_id": "10db7c95-ea79-4283-b354-cac06c940a80",
      "call_status": "closed",
      "closed_at": "string",
      "created_at": "string",
      "expected_deal_value": 5000,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "lead": {
        "email": "jane@example.com",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "Jane Doe"
      },
      "lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",
      "scheduled_at": "2026-07-01T15:00:00.000Z",
      "stage": "booked",
      "updated_at": "string"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "string"
  }
}

{
  "code": "NOT_FOUND",
  "error": "Lead not found",
  "requestId": "req_abc123",
  "success": false
}