---
title: "List mail handoff metadata within the 72 hour window"
method: GET
path: "/v1/projects/{project_id}/environments/{environment_id}/mail/messages"
---

# List mail handoff metadata within the 72 hour window

`GET /v1/projects/{project_id}/environments/{environment_id}/mail/messages`

## Request

- Base URL: `https://app.ohmyho.st`
- URL: `https://app.ohmyho.st/v1/projects/{project_id}/environments/{environment_id}/mail/messages`
- Auth: HTTP bearer

One production mail domain per project; environment_id is the project Prod environment ID. Dev and Prod application URLs do not create separate mail domains. Provider credentials never leave ohmyho.st. Content expires 72 hours after original receipt.

## Path parameters

- `project_id` string, required
- `environment_id` string, required

## Query parameters

- `after` string

## Headers

- `X-Request-Id` string

## Response `200`

Authorized mail result.

- ManagedMailMessagePage
  - `items` object[], required
    - `message_id` string, required
    - `received_at` string, date-time, required
    - `state` 'pending' | 'delivering' | 'delivered' | 'delivery_failed' | 'expired', required
    - `attempts` integer, required

## Other responses

- `400`: The request failed.
- `401`: The request failed.
- `403`: The request failed.
- `404`: The request failed.
- `409`: The request failed.
- `429`: The request failed.
- `503`: The request failed.

---

[API](https://skmtc.dev/ohmyho/apis/ohmyho-st-api.md) · [All operations](https://skmtc.dev/ohmyho/apis/ohmyho-st-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ohmyho/apis/ohmyho-st-api/revisions/d069888c0017?raw)