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

# Return mail headers

`GET /characters/{character_id}/mail`

## Request

- Base URL: `https://esi.evetech.net`
- URL: `https://esi.evetech.net/characters/{character_id}/mail`
- Auth: OAuth 2
  - Authorization code: `https://login.eveonline.com/v2/oauth/authorize`
  - Token URL: `https://login.eveonline.com/v2/oauth/token` scopes: `esi-mail.read_mail.v1`
- TypeScript: <https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/docs/characters/:character_id/mail/get.ts> (a function with typed inputs; its response is checked against the schema)

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
- `If-Modified-Since` 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

## Changes

- **2026-07-27** `0b913165e49c`: 1 info
  - added the optional property `status` to the response with the `default` status

[Operation history](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/changes/characters/:character_id/mail/get.md)

---

[API](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility.md) - [All operations](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/llms.txt) - [OpenAPI document](https://skmtc.dev/evetech/apis/eve-spring-inebriation-esi-tranquility/revisions/110d1a0b1dfc?raw)