---
title: "Get mail labels and unread counts"
method: GET
path: "/characters/{character_id}/mail/labels"
tags: ["Mail"]
---

# Get mail labels and unread counts

`GET /characters/{character_id}/mail/labels`

Return a list of the users mail labels, unread counts for each label and a total unread count.

## Path parameters

- `character_id` integer, required

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

- CharactersCharacterIdMailLabelsGet
  - `labels` object[]
    - `color` '#0000fe' | '#006634' | '#0099ff' | '#00ff33' | '#01ffff' | '#349800' | '#660066' | '#666666' | '#999999' | '#99ffff' | '#9a0000' | '#ccff9a' | '#e6e6e6' | '#fe0000' | '#ff6600' | '#ffff01' | '#ffffcd' | '#ffffff'
    - `label_id` integer
    - `name` string
    - `unread_count` integer
  - `total_unread_count` integer

## 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/revisions/7bad2f0024dd/schema)