---
title: "Get bulk session status"
method: GET
path: "/api/v2/bulks/{id}"
tags: ["Outbound Messages"]
---

# Get bulk session status

`GET /api/v2/bulks/{id}`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Messages%3A%20Send%0A/getBulkSession" target="_blank">Try in sandbox</a><br>

## Path parameters

- `id` integer, required

## Response `200`

Returned when successful.

- BulkSession
  - `id` integer, required — Bulk Session ID.
  - `status` 'n' | 'w' | 'f' | 'c' | 's', required — * **n** – bulk session is just created * **w** - work in progress * **f** - failed * **c** - completed with success * **s** - suspended
  - `itemsProcessed` integer, nullable, required — Amount of messages already processed.
  - `itemsTotal` integer, nullable, required — Total amount of messages to be processed.
  - `createdAt` string, date-time, required — Creation date and time of a Bulk Session.
  - `session` MessageSession, nullable, required
    - `id` integer, required — Session ID.
    - `startTime` string, nullable, required — Session creation time.
    - `text` string, nullable, required — Session text. If a template was used for the session text (see [Messages: Send](https://docs.textmagic.com/#tag/Outbound-Messages) for details), it may contain template tags.
    - `source` string, nullable, required — * **O** – for Textmagic Online; * **A** – for API; * **M** – for Textmagic Messenger; * **E** – for [Email to SMS](https://docs.textmagic.com/#tag/Send-Email-to-SMS); * **X** – for [Distribution Lists](https://docs.textmagic.com/#tag/Distribution-Lists).
    - `referenceId` string, nullable, required — Custom reference ID (see [Messages: Send](https://docs.textmagic.com/#tag/Send-Email-to-SMS) for details).
    - `price` number, nullable, required — Session cost (in account currency).
    - `numbersCount` integer, nullable, required — Session recipient count.
    - `destination` 't' | 's' | 'v', nullable, required — Destination type of a Message Session: * **t** – text SMS; * **s** – text-to-speech; * **v** – voice broadcast.
    - `initiatorId` integer, nullable, required — Initiator ID.
    - `title` string, nullable, required
  - `text` string, nullable, required — Message text of a Bulk Session.

## Other responses

- `401` — Unauthorized request.
- `404` — Request data not found.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)