---
title: "Return mail headers"
method: GET
path: "/characters/{character_id}/mail"
tags: ["Mail"]
---

# Return mail headers

`GET /characters/{character_id}/mail`

Return the 50 most recent mail headers belonging to the character that match the query criteria. Queries can be filtered by label, and last_mail_id can be used to paginate backwards

## Path parameters

- `character_id` integer, required

## Query parameters

- `labels` integer[] — Fetch only mails that match one or more of the given labels
- `last_mail_id` integer — List only mail with an ID lower than the given ID, if present

## Headers

- `Accept-Language` 'en' | 'de' | 'fr' | 'ja' | 'ru' | 'zh' | 'ko' | 'es'
- `If-None-Match` string
- `X-Compatibility-Date` '2025-12-16', date, required
- `X-Tenant` string

## Response `200`

OK

- object[]
  - `from` integer — From whom the mail was sent
  - `is_read` boolean
  - `labels` integer[]
  - `mail_id` integer
  - `recipients` object[] — Recipients of the mail
    - `recipient_id` integer, required
    - `recipient_type` 'alliance' | 'character' | 'corporation' | 'mailing_list', required
  - `subject` string — Mail subject
  - `timestamp` string, date-time — When the mail was sent

## Other responses

- `default` — Error

---

[API](https://skmtc.net/evemonk/apis/eve-stable-infrastructure-esi-tranquility.md) · [All operations](https://skmtc.net/evemonk/apis/eve-stable-infrastructure-esi-tranquility/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/evemonk/eve-stable-infrastructure-esi-tranquility/versions/7bad2f0024dd/schema)