Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

EVE Online Mail API

The Mail API from EVE Online — 13 operation(s) for mail.

EVE Online Mail API is one of 50 APIs that EVE Online publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Mail. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, best-practice docs, and rate-limit docs.

This API exposes 20 operations across 13 paths, and defines 7 schemas. It is described by OpenAPI 3.0.0, at version 1.36.

Requests are made against a single base URL, https://esi.evetech.net/latest.

20 operations 13 paths 7 schemas 4 DELETE10 GET4 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.36
Base URL
https://esi.evetech.net/latest
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

EVE Online Mail API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (evesso) using the implicit flow, exposing 63 scopes.

Paths & Operations 20

Across 13 paths, the API surfaces 20 operations — 4 DELETE, 10 GET, 4 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Mail 20
GET
/characters/{character_id}/mail/
EVE Online Return Mail Headers
get_characters_character_id_mail 6 params → 200304400401403420500503
POST
/characters/{character_id}/mail/
EVE Online Send a New Mail
post_characters_character_id_mail 3 params body → 201400401403420500503504
GET
/characters/{character_id}/mail/labels/
EVE Online Get Mail Labels and Unread Counts
get_characters_character_id_mail_labels 4 params → 200304400401403420500503
POST
/characters/{character_id}/mail/labels/
EVE Online Create a Mail Label
post_characters_character_id_mail_labels 3 params body → 201400401403420500503504
DELETE
/characters/{character_id}/mail/labels/{label_id}/
EVE Online Delete a Mail Label
delete_characters_character_id_mail_labels_label_id 4 params → 204400401403420422500503
GET
/characters/{character_id}/mail/lists/
EVE Online Return Mailing List Subscriptions
get_characters_character_id_mail_lists 4 params → 200304400401403420500503
DELETE
/characters/{character_id}/mail/{mail_id}/
EVE Online Delete a Mail
delete_characters_character_id_mail_mail_id 4 params → 204400401403420500503504
GET
/characters/{character_id}/mail/{mail_id}/
EVE Online Return a Mail
get_characters_character_id_mail_mail_id 5 params → 200304400401403404420500
PUT
/characters/{character_id}/mail/{mail_id}/
EVE Online Update Metadata About a Mail
put_characters_character_id_mail_mail_id 4 params body → 204400401403420500503504
GET
/v1/characters/{character_id}/mail/
Return mail headers
get_characters_character_id_mail 6 params → 200304400401403420500503
POST
/v1/characters/{character_id}/mail/
Send a new mail
post_characters_character_id_mail 4 params → 201400401403420500503504
DELETE
/v1/characters/{character_id}/mail/labels/{label_id}/
Delete a mail label
delete_characters_character_id_mail_labels_label_id 4 params → 204400401403420422500503
GET
/v1/characters/{character_id}/mail/lists/
Return mailing list subscriptions
get_characters_character_id_mail_lists 4 params → 200304400401403420500503
DELETE
/v1/characters/{character_id}/mail/{mail_id}/
Delete a mail
delete_characters_character_id_mail_mail_id 4 params → 204400401403420500503504
GET
/v1/characters/{character_id}/mail/{mail_id}/
Return a mail
get_characters_character_id_mail_mail_id 5 params → 200304400401403404420500
PUT
/v1/characters/{character_id}/mail/{mail_id}/
Update metadata about a mail
put_characters_character_id_mail_mail_id 5 params → 204400401403420500503504
POST
/v2/characters/{character_id}/mail/labels/
Create a mail label
post_characters_character_id_mail_labels 4 params → 201400401403420500503504
GET
/v3/characters/{character_id}/mail/labels/
Get mail labels and unread counts
get_characters_character_id_mail_labels 4 params → 200304400401403420500503
GET
/characters/{character_id}/mail/unread/deprecated
Return the number of unread mails
get_characters_character_id_mail_unread 4 params → 200304400401403420500503
GET
/v1/characters/{character_id}/mail/unread/deprecated
Return the number of unread mails
get_characters_character_id_mail_unread 4 params → 200304400401403420500503

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are gateway_timeout (2 properties), forbidden (2 properties), error_limited (1 property), unauthorized (1 property). Each schema is shown below with its type and property counts.

internal_server_error
object
Internal server error model
1 property 1 required
forbidden
object
Forbidden model
2 properties 1 required
service_unavailable
object
Service unavailable model
1 property 1 required
bad_request
object
Bad request model
1 property 1 required
unauthorized
object
Unauthorized model
1 property 1 required
gateway_timeout
object
Gateway timeout model
2 properties 1 required
error_limited
object
Error limited model
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

eve-online-mail-api-openapi.yml Raw ↑

Other APIs EVE Online publishes across the network.

EVE Single Sign-On (SSO)
EVE Image Server (IEC)
EVE Static Data Export (SDE)
EVE Online Game Client
EVE Online agent API
EVE Online Alliance API
EVE Online Assets API
EVE Online Calendar API
EVE Online Character API
EVE Online Clones API
EVE Online Contacts API
EVE Online Contracts API