> ## Documentation Index
> Fetch the complete documentation index at: https://docs.api.aura-app.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# leads

> List leads with filters and pagination

Returns leads for the authenticated organization only.
Uses Relay-style pagination for efficient large dataset handling.
@param first - Number of results per page (1-100, default: 50)
@param after - Pagination cursor from previous response
@param status - Filter by lead status
@param hasScheduledCall - Filter leads with/without scheduled calls
@returns Relay Connection with edges and pageInfo
@example ```graphql
query {
  leads(first: 10, status: new) {
    edges {
      node {
        id
        name
        email
        status
        totalRevenue { formatted }
        hasScheduledCall
        calls(args: { first: 5 }) {
          edges {
            node {
              scheduledAt
              status
            }
          }
        }
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
```