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

# Listar Leads

> Retorna uma lista de todos os leads

## Request

<ParamField query="limit" type="integer" default="50">
  Número máximo de leads a retornar
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Número de leads a pular (para paginação)
</ParamField>

<ParamField query="search" type="string">
  Buscar por nome, email ou telefone
</ParamField>

<ParamField query="status_id" type="string">
  Filtrar por ID do status
</ParamField>

## Response

<ResponseField name="array" type="Lead[]">
  Lista de leads
</ResponseField>

<Expandable title="Propriedades do Lead">
  <ResponseField name="id" type="string">
    UUID único do lead
  </ResponseField>

  <ResponseField name="tenant_id" type="string">
    UUID do tenant
  </ResponseField>

  <ResponseField name="name" type="string">
    Nome completo
  </ResponseField>

  <ResponseField name="email" type="string">
    Email do lead
  </ResponseField>

  <ResponseField name="phone" type="string">
    Telefone do lead
  </ResponseField>

  <ResponseField name="company" type="string">
    Empresa do lead
  </ResponseField>

  <ResponseField name="status_id" type="string">
    ID do status atual
  </ResponseField>

  <ResponseField name="status" type="object">
    Objeto do status com id, name, color
  </ResponseField>

  <ResponseField name="tags" type="array">
    Lista de tags associadas
  </ResponseField>

  <ResponseField name="session_id" type="string">
    ID da sessão ativa (se houver)
  </ResponseField>

  <ResponseField name="session_status" type="string">
    Status da sessão: `active`, `inactive`
  </ResponseField>

  <ResponseField name="created_at" type="string">
    Data de criação (ISO 8601)
  </ResponseField>

  <ResponseField name="updated_at" type="string">
    Data da última atualização (ISO 8601)
  </ResponseField>
</Expandable>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/leads?limit=10" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.leavo.ai/backend/leads?limit=10', {
    headers: {
      'Authorization': 'Bearer sua_chave_aqui'
    }
  });

  const leads = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.leavo.ai/backend/leads',
      params={'limit': 10},
      headers={'Authorization': 'Bearer sua_chave_aqui'}
  )

  leads = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tenant_id": "660e8400-e29b-41d4-a716-446655440000",
      "name": "João Silva",
      "email": "joao@exemplo.com",
      "phone": "+5511999999999",
      "company": "Empresa XYZ",
      "status_id": "770e8400-e29b-41d4-a716-446655440000",
      "status": {
        "id": "770e8400-e29b-41d4-a716-446655440000",
        "name": "Novo",
        "description": "Lead novo",
        "color": "#007bff",
        "default": true
      },
      "tags": [
        {
          "id": "880e8400-e29b-41d4-a716-446655440000",
          "name": "VIP",
          "color": "#ffc107"
        }
      ],
      "session_id": "990e8400-e29b-41d4-a716-446655440000",
      "session_status": "active",
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ]
  ```
</ResponseExample>