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

- `page_size` integer
- `page_token` string
- `status` integer
- `recipient` string

## Response `200`

Paginated Courier Message List Response

- 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` JSONRawMessage
    - `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` integer, 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' | 'verifiable_address_changed' | 'authenticator_key_added', 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 verifiable_address_changed TypeVerifiableAddressChanged authenticator_key_added TypeAuthenticatorKeyAdded
  - `type` integer, 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

---

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