Get contact labels

GET

/characters/{character_id}/contacts/labels/

Return custom labels for a character's contacts

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

Alternate route: /legacy/characters/{character_id}/contacts/labels/

Alternate route: /v1/characters/{character_id}/contacts/labels/

This route is cached for up to 300 seconds

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://esi.evetech.net/latest/characters//contacts/labels/'

Response Example

200 - response

[
    {
        "label_id": 123,
        "label_name": "Friends"
    }
]

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 contact labels

application/json

Body

200 ok array

array of:

label_id

integer <int64>

get_characters_character_id_contacts_labels_label_id

required

label_id integer

label_name

string

get_characters_character_id_contacts_labels_label_name

required

label_name string

🔵304Not modified

🟠400Bad request

🟠401Unauthorized

🟠403Forbidden

🟠420Error limited

🔴500Internal server error

🔴503Service unavailable

🔴504Gateway timeout

Modified at 2023-08-15 09:13:23

Edit contacts

Get corporation contacts