> ## 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.

# Send status

> Check the status and progress of a bulk send

## Description

Allows you to check the current status and detailed progress of a bulk send. Includes counters for sent, delivered, read, and failed messages, plus the progress percentage.

## Authentication header

<ParamField header="X-API-Key" type="string" required>
  Your Mindo API Key. Format: `mindo_xxxxxxxxxxxxxxxxxxxxxxxx`
</ParamField>

## Path parameters

<ParamField path="bulk_send_id" type="string (UUID)" required>
  Bulk send ID obtained when creating the send with [Send bulk](/en/api-reference/envio-masivo/enviar-masivo).
</ParamField>

## Response

<ResponseField name="id" type="string (UUID)">
  Unique bulk send ID.
</ResponseField>

<ResponseField name="status" type="string">
  Current send status. See [status table](#possible-statuses).
</ResponseField>

<ResponseField name="template" type="object">
  Information about the template used.

  <Expandable title="template properties">
    <ResponseField name="id" type="integer">
      Internal template ID.
    </ResponseField>

    <ResponseField name="template_name" type="string">
      Template name.
    </ResponseField>

    <ResponseField name="language" type="string">
      Template language.
    </ResponseField>

    <ResponseField name="status" type="string">
      Template status in Meta (`APPROVED`).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="phone_number" type="object">
  Information about the sender WhatsApp number.

  <Expandable title="phone_number properties">
    <ResponseField name="id" type="integer">
      Internal number ID.
    </ResponseField>

    <ResponseField name="display_phone_number" type="string">
      Formatted display number.
    </ResponseField>

    <ResponseField name="verified_name" type="string">
      Meta-verified name.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total_recipients" type="integer">
  Total send recipients.
</ResponseField>

<ResponseField name="sent_count" type="integer">
  Number of messages sent.
</ResponseField>

<ResponseField name="delivered_count" type="integer">
  Number of messages delivered to the recipient.
</ResponseField>

<ResponseField name="read_count" type="integer">
  Number of messages read by the recipient.
</ResponseField>

<ResponseField name="failed_count" type="integer">
  Number of failed messages.
</ResponseField>

<ResponseField name="pending_count" type="integer">
  Number of messages pending sending.
</ResponseField>

<ResponseField name="progress_percentage" type="float">
  Send progress percentage (0-100).
</ResponseField>

<ResponseField name="estimated_time_minutes" type="float">
  Estimated processing time in minutes.
</ResponseField>

<ResponseField name="started_at" type="string (ISO 8601)">
  Date and time when processing started. `null` if not yet started.
</ResponseField>

<ResponseField name="completed_at" type="string (ISO 8601)">
  Date and time when processing finished. `null` if not completed.
</ResponseField>

<ResponseField name="created_at" type="string (ISO 8601)">
  Send creation date and time.
</ResponseField>

<ResponseField name="created_by" type="object">
  User who created the send.

  <Expandable title="created_by properties">
    <ResponseField name="id" type="integer">
      User ID.
    </ResponseField>

    <ResponseField name="email" type="string">
      User email.
    </ResponseField>

    <ResponseField name="first_name" type="string">
      User first name.
    </ResponseField>

    <ResponseField name="last_name" type="string">
      User last name.
    </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"Progress: {data['progress_percentage']}%")
  print(f"Sent: {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(`Progress: ${data.progress_percentage}%`);
  console.log(`Sent: ${data.sent_count}/${data.total_recipients}`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Completed 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 - In progress 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 - Not found theme={null}
  {
    "detail": "Not found."
  }
  ```

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

## Possible statuses

| Status       | Description                            |
| ------------ | -------------------------------------- |
| `QUEUED`     | Send created and queued for processing |
| `PROCESSING` | Actively sending messages              |
| `COMPLETED`  | All messages processed successfully    |
| `PARTIAL`    | Processed with some failures           |
| `FAILED`     | Send failed completely                 |
| `CANCELLED`  | Send cancelled manually                |

<Note>
  To see the detail of each individual message, use the [Send messages](/en/api-reference/envio-masivo/mensajes-envio) endpoint.
</Note>