---
title: "Get a session`s details"
method: GET
path: "/api/v2/sessions/{id}"
tags: ["Outbound Message Sessions"]
---

# Get a session`s details

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

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Sessions/getMessageSession" target="_blank">Try in sandbox</a><br>Get a specific session’s details.

## Path parameters

- `id` integer, required

## Response `200`

Returned when successful.

- MessageSession, nullable
  - `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

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