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

# Status do envio

> Verificar o status e progresso de um envio em massa

## Descrição

Permite verificar o status atual e o progresso detalhado de um envio em massa. Inclui contadores de mensagens enviadas, entregues, lidas e com falha, além do percentual de progresso.

## Header de autenticação

<ParamField header="X-API-Key" type="string" required>
  Sua API Key da Mindo. Formato: `mindo_xxxxxxxxxxxxxxxxxxxxxxxx`
</ParamField>

## Parâmetros de path

<ParamField path="bulk_send_id" type="string (UUID)" required>
  ID do envio em massa obtido ao criar o envio com [Envio em massa](/pt/api-reference/envio-masivo/enviar-masivo).
</ParamField>

## Resposta

<ResponseField name="id" type="string (UUID)">
  ID único do envio em massa.
</ResponseField>

<ResponseField name="status" type="string">
  Status atual do envio. Consulte a [tabela de status](#status-possiveis).
</ResponseField>

<ResponseField name="template" type="object">
  Informações sobre o template utilizado.

  <Expandable title="Propriedades de template">
    <ResponseField name="id" type="integer">
      ID interno do template.
    </ResponseField>

    <ResponseField name="template_name" type="string">
      Nome do template.
    </ResponseField>

    <ResponseField name="language" type="string">
      Idioma do template.
    </ResponseField>

    <ResponseField name="status" type="string">
      Status do template na Meta (`APPROVED`).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="phone_number" type="object">
  Informações sobre o número do WhatsApp remetente.

  <Expandable title="Propriedades de phone_number">
    <ResponseField name="id" type="integer">
      ID interno do número.
    </ResponseField>

    <ResponseField name="display_phone_number" type="string">
      Número formatado para exibição.
    </ResponseField>

    <ResponseField name="verified_name" type="string">
      Nome verificado pela Meta.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total_recipients" type="integer">
  Total de destinatários do envio.
</ResponseField>

<ResponseField name="sent_count" type="integer">
  Número de mensagens enviadas.
</ResponseField>

<ResponseField name="delivered_count" type="integer">
  Número de mensagens entregues ao destinatário.
</ResponseField>

<ResponseField name="read_count" type="integer">
  Número de mensagens lidas pelo destinatário.
</ResponseField>

<ResponseField name="failed_count" type="integer">
  Número de mensagens com falha.
</ResponseField>

<ResponseField name="pending_count" type="integer">
  Número de mensagens pendentes de envio.
</ResponseField>

<ResponseField name="progress_percentage" type="float">
  Percentual de progresso do envio (0-100).
</ResponseField>

<ResponseField name="estimated_time_minutes" type="float">
  Tempo estimado de processamento em minutos.
</ResponseField>

<ResponseField name="started_at" type="string (ISO 8601)">
  Data e hora de início do processamento. `null` se ainda não iniciou.
</ResponseField>

<ResponseField name="completed_at" type="string (ISO 8601)">
  Data e hora de conclusão do processamento. `null` se não concluído.
</ResponseField>

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

<ResponseField name="created_by" type="object">
  Usuário que criou o envio.

  <Expandable title="Propriedades de created_by">
    <ResponseField name="id" type="integer">
      ID do usuário.
    </ResponseField>

    <ResponseField name="email" type="string">
      E-mail do usuário.
    </ResponseField>

    <ResponseField name="first_name" type="string">
      Nome do usuário.
    </ResponseField>

    <ResponseField name="last_name" type="string">
      Sobrenome do usuário.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
    -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
  ```

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

  bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"

  response = requests.get(
      f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/",
      headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
  )

  data = response.json()
  print(f"Status: {data['status']}")
  print(f"Progresso: {data['progress_percentage']}%")
  print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
  ```

  ```javascript JavaScript theme={null}
  const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";

  const response = await fetch(
    `https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
    {
      headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  );

  const data = await response.json();
  console.log(`Status: ${data.status}`);
  console.log(`Progresso: ${data.progress_percentage}%`);
  console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Concluído theme={null}
  {
    "id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "status": "COMPLETED",
    "template": {
      "id": 45,
      "template_name": "welcome_message",
      "language": "es",
      "status": "APPROVED"
    },
    "phone_number": {
      "id": 123,
      "display_phone_number": "+54 9 223 675-0780",
      "verified_name": "Mindo Software"
    },
    "total_recipients": 3,
    "sent_count": 3,
    "delivered_count": 2,
    "read_count": 1,
    "failed_count": 0,
    "pending_count": 0,
    "progress_percentage": 100.0,
    "estimated_time_minutes": 0.4,
    "started_at": "2025-11-16T21:30:05Z",
    "completed_at": "2025-11-16T21:30:28Z",
    "created_at": "2025-11-16T21:30:00Z",
    "created_by": {
      "id": 1,
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe"
    }
  }
  ```

  ```json 200 - Em andamento theme={null}
  {
    "id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "status": "PROCESSING",
    "template": {
      "id": 45,
      "template_name": "welcome_message",
      "language": "es",
      "status": "APPROVED"
    },
    "phone_number": {
      "id": 123,
      "display_phone_number": "+54 9 223 675-0780",
      "verified_name": "Mindo Software"
    },
    "total_recipients": 100,
    "sent_count": 45,
    "delivered_count": 30,
    "read_count": 10,
    "failed_count": 2,
    "pending_count": 53,
    "progress_percentage": 47.0,
    "estimated_time_minutes": 6.0,
    "started_at": "2025-11-16T21:30:05Z",
    "completed_at": null,
    "created_at": "2025-11-16T21:30:00Z",
    "created_by": {
      "id": 1,
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe"
    }
  }
  ```

  ```json 404 - Não encontrado theme={null}
  {
    "detail": "Not found."
  }
  ```

  ```json 401 - Não autenticado theme={null}
  {
    "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
  }
  ```
</ResponseExample>

## Status possíveis

| Status       | Descrição                                  |
| ------------ | ------------------------------------------ |
| `QUEUED`     | Envio criado e na fila para processamento  |
| `PROCESSING` | Enviando mensagens ativamente              |
| `COMPLETED`  | Todas as mensagens processadas com sucesso |
| `PARTIAL`    | Processado com algumas falhas              |
| `FAILED`     | Envio falhou completamente                 |
| `CANCELLED`  | Envio cancelado manualmente                |

<Note>
  Para ver o detalhe de cada mensagem individual, use o endpoint [Mensagens do envio](/pt/api-reference/envio-masivo/mensajes-envio).
</Note>