> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar leads

> Lista todos os leads do usuário autenticado com paginação e filtros, retornando contatos, variáveis personalizadas e status atual de cada lead.

Este endpoint permite listar todos os leads pertencentes ao usuário autenticado.

### Campos da Resposta

<ResponseField name="leads" type="array">
  <Expandable title="propriedades">
    <ResponseField name="id" type="integer">
      ID do lead
    </ResponseField>

    <ResponseField name="campaign_id" type="integer">
      ID da campanha à qual este lead pertence
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Número de telefone do lead no formato E.164
    </ResponseField>

    <ResponseField name="variables" type="object">
      Variáveis associadas ao lead
    </ResponseField>

    <ResponseField name="status" type="string">
      Status do lead
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Data e hora de criação do lead
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Data e hora da última atualização do lead
    </ResponseField>

    <ResponseField name="campaign" type="object">
      Informações da campanha

      <Expandable title="propriedades de campaign">
        <ResponseField name="id" type="integer">
          ID da campanha
        </ResponseField>

        <ResponseField name="name" type="string">
          Nome da campanha
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="secondary_contacts" type="array">
      Array de contatos secundários associados a este lead

      <Expandable title="propriedades de secondary_contacts">
        <ResponseField name="id" type="integer">
          ID do contato secundário
        </ResponseField>

        <ResponseField name="phone_number" type="string">
          Número de telefone do contato secundário no formato E.164
        </ResponseField>

        <ResponseField name="variables" type="object">
          Variáveis associadas ao contato secundário
        </ResponseField>

        <ResponseField name="status" type="string">
          Status do contato secundário
        </ResponseField>

        <ResponseField name="created_at" type="string">
          Data e hora de criação do contato secundário
        </ResponseField>

        <ResponseField name="updated_at" type="string">
          Data e hora da última atualização do contato secundário
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "campaign_id": 1,
      "phone_number": "+1234567890",
      "variables": {
        "customer_name": "John Doe",
        "email": "john.doe@example.com"
      },
      "status": "created",
      "created_at": "2025-06-30 11:18:04",
      "updated_at": "2025-06-30 11:18:04",
      "campaign": {
        "id": 1,
        "name": "Minha nova campanha"
      },
      "secondary_contacts": [
        {
          "id": 2,
          "phone_number": "+1234567899",
          "variables": {
            "customer_name": "Jane Doe Secondary",
            "email": "jane.doe.secondary@example.com"
          },
          "status": "created",
          "created_at": "2025-06-30 11:18:04",
          "updated_at": "2025-06-30 11:18:04"
        }
      ]
    }
  ]
  ```
</ResponseExample>