---
title: "List Messages"
method: GET
path: "/admin/courier/messages"
tags: ["courier"]
---

# List Messages

`GET /admin/courier/messages`

Lists all messages by given status and recipient.

## Query parameters

- `per_page` integer
- `page` integer
- `status` 'queued' | 'sent' | 'processing' | 'abandoned' — A Message's Status
- `recipient` string

## Response `200`

Paginated Courier Message List Response

- Message[]
  - `body` string
  - `created_at` string, date-time — CreatedAt is a helper struct field for gobuffalo.pop.
  - `id` string, uuid
  - `recipient` string
  - `send_count` integer
  - `status` 'queued' | 'sent' | 'processing' | 'abandoned' — A Message's Status
  - `subject` string
  - `template_type` 'recovery_invalid' | 'recovery_valid' | 'recovery_code_invalid' | 'recovery_code_valid' | 'verification_invalid' | 'verification_valid' | 'verification_code_invalid' | 'verification_code_valid' | 'otp' | 'stub'
  - `type` 'email' | 'phone' — It can either be `email` or `phone`
  - `updated_at` string, date-time — UpdatedAt is a helper struct field for gobuffalo.pop.

## Other responses

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

## Changes

- **2022-12-02** `b6e5ffa30d4c` — 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/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/b6e5ffa30d4c/schema)