---
title: "Get a Message"
method: GET
path: "/admin/courier/messages/{id}"
tags: ["courier"]
---

# Get a Message

`GET /admin/courier/messages/{id}`

Gets a specific messages by the given ID.

## Path parameters

- `id` string, required

## Response `200`

message

- Message
  - `body` string, required
  - `channel` string
  - `created_at` string, date-time, required — CreatedAt is a helper struct field for gobuffalo.pop.
  - `dispatches` MessageDispatch[] — Dispatches store information about the attempts of delivering a message May contain an error if any happened, or just the `success` state.
    - `created_at` string, date-time, required — CreatedAt is a helper struct field for gobuffalo.pop.
    - `error` object
    - `id` string, uuid, required — The ID of this message dispatch
    - `message_id` string, uuid, required — The ID of the message being dispatched
    - `status` 'failed' | 'success', required — The status of this dispatch Either "failed" or "success" failed CourierMessageDispatchStatusFailed success CourierMessageDispatchStatusSuccess
    - `updated_at` string, date-time, required — UpdatedAt is a helper struct field for gobuffalo.pop.
  - `id` string, uuid, required
  - `recipient` string, required
  - `send_count` integer, required
  - `status` 'queued' | 'sent' | 'processing' | 'abandoned', required — A Message's Status
  - `subject` string, required
  - `template_type` 'recovery_invalid' | 'recovery_valid' | 'recovery_code_invalid' | 'recovery_code_valid' | 'verification_invalid' | 'verification_valid' | 'verification_code_invalid' | 'verification_code_valid' | 'stub' | 'login_code_valid' | 'registration_code_valid', required — recovery_invalid TypeRecoveryInvalid recovery_valid TypeRecoveryValid recovery_code_invalid TypeRecoveryCodeInvalid recovery_code_valid TypeRecoveryCodeValid verification_invalid TypeVerificationInvalid verification_valid TypeVerificationValid verification_code_invalid TypeVerificationCodeInvalid verification_code_valid TypeVerificationCodeValid stub TypeTestStub login_code_valid TypeLoginCodeValid registration_code_valid TypeRegistrationCodeValid
  - `type` 'email' | 'phone', required — It can either be `email` or `phone`
  - `updated_at` string, date-time, required — UpdatedAt is a helper struct field for gobuffalo.pop.

## Other responses

- `400` — errorGeneric
- `default` — errorGeneric

## Changes

- **2024-02-20** `4f071812f3ea` — 2 warning, 2 info
  - added the new `login_code_valid` enum value to the `template_type` response property for the response status `200`
  - added the new `registration_code_valid` enum value to the `template_type` response property for the response status `200`
  - added the optional property `channel` to the response with the `200` status
  - removed the `otp` enum value from the `template_type` response property for the response status `200`
- **2023-01-14** `3f9901877db9` — 1 info
  - endpoint added
- **2021-05-05** `381c760af46e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ory/apis/ory-identities-api/changes/admin/courier/messages/:id/get.md)

---

[API](https://skmtc.dev/ory/apis/ory-identities-api.md) · [All operations](https://skmtc.dev/ory/apis/ory-identities-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ory/ory-identities-api/revisions/7a0df90e2f13/schema)