Get mail labels and unread counts - EVE Swagger Interface

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

Alternate route: /dev/characters/{character_id}/mail/labels/

Alternate route: /v3/characters/{character_id}/mail/labels/

This route is cached for up to 30 seconds

{ "labels": [ { "color": "#660066", "label_id": 16, "name": "PINK", "unread_count": 4 }, { "color": "#ffffff", "label_id": 17, "name": "WHITE", "unread_count": 1 } ], "total_unread_count": 5 }

Request

Path Params

character_id

integer

required

An EVE character ID

Query Params

datasource

string

optional

The server name you would like data from

token

string

optional

Access token to use if unable to set a header

Header Params

If-None-Match

string

optional

ETag from a previous request. A 304 will be returned if this matches the current ETag

Responses

🟢200A list of mail labels and unread counts

application/json

Body

200 ok object

labels

array[object (get_characters_character_id_mail_labels_label) {4}]

get_characters_character_id_mail_labels_labels

optional

labels array

<= 30 items

color

enum<string>

get_characters_character_id_mail_labels_color

optional

color string

Allowed values:

#0000fe#006634#0099ff#00ff33#01ffff#349800#660066#666666#999999#99ffff#9a0000#ccff9a#e6e6e6#fe0000#ff6600#ffff01#ffffcd#ffffff

Default:

#ffffff

label_id

integer <int32>

get_characters_character_id_mail_labels_label_id

optional

label_id integer

>= 0

name

string

get_characters_character_id_mail_labels_name

optional

name string

<= 40 characters

unread_count

integer <int32>

get_characters_character_id_mail_labels_unread_count

optional

unread_count integer

>= 0

total_unread_count

integer <int32>

get_characters_character_id_mail_labels_total_unread_count

optional

total_unread_count integer

>= 0

🔵304Not modified

🟠400Bad request

🟠401Unauthorized

🟠403Forbidden

🟠420Error limited

🔴500Internal server error

🔴503Service unavailable

🔴504Gateway timeout