---
title: "Get all bulk sessions"
method: GET
path: "/api/v2/bulks"
tags: ["Outbound Messages"]
---

# Get all bulk sessions

`GET /api/v2/bulks`

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

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Returned when successful.

- GetAllBulkSessionsPaginatedResponse
  - `page` integer, required
  - `pageCount` integer, required — The total number of pages.
  - `limit` integer, required — The number of results per page.
  - `resources` BulkSession[], required
    - `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.

---

[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)