EVE Swagger Interface
  1. Mail
EVE Swagger Interface
  • Alliance
    • List all alliances
      GET
    • Get alliance information
      GET
    • List alliance's corporations
      GET
    • Get alliance icon
      GET
  • Contacts
    • Get alliance contacts
      GET
    • Get alliance contact labels
      GET
    • Delete contacts
      DELETE
    • Get contacts
      GET
    • Add contacts
      POST
    • Edit contacts
      PUT
    • Get contact labels
      GET
    • Get corporation contacts
      GET
    • Get corporation contact labels
      GET
  • Character
    • Character affiliation
      POST
    • Get character's public information
      GET
    • Get agents research
      GET
    • Get blueprints
      GET
    • Get corporation history
      GET
    • Calculate a CSPA charge cost
      POST
    • Get jump fatigue
      GET
    • Get medals
      GET
    • Get character notifications
      GET
    • Get new contact notifications
      GET
    • Get character portraits
      GET
    • Get character corporation roles
      GET
    • Get standings
      GET
    • Yearly aggregate stats
      GET
    • Get character corporation titles
      GET
  • Assets
    • Get character assets
    • Get character asset locations
    • Get character asset names
    • Get corporation assets
    • Get corporation asset locations
    • Get corporation asset names
  • Skills
    • Get character attributes
    • Get character's skill queue
    • Get character skills
  • Bookmarks
    • List bookmarks
    • List bookmark folders
    • List corporation bookmarks
    • List corporation bookmark folders
  • Calendar
    • List calendar event summaries
    • Get an event
    • Respond to an event
    • Get attendees
  • Clones
    • Get clones
    • Get active implants
  • Contracts
    • Get contracts
    • Get contract bids
    • Get contract items
    • Get public contract bids
    • Get public contract items
    • Get public contracts
    • Get corporation contracts
    • Get corporation contract bids
    • Get corporation contract items
  • Fittings
    • Get fittings
    • Create fitting
    • Delete fitting
  • Fleets
    • Get character fleet info
    • Get fleet information
    • Update fleet
    • Get fleet members
    • Create fleet invitation
    • Kick fleet member
    • Move fleet member
    • Delete fleet squad
    • Rename fleet squad
    • Get fleet wings
    • Create fleet wing
    • Delete fleet wing
    • Rename fleet wing
    • Create fleet squad
  • Faction Warfare
    • Overview of a character involved in faction warfare
    • Overview of a corporation involved in faction warfare
    • List of the top factions in faction warfare
    • List of the top pilots in faction warfare
    • List of the top corporations in faction warfare
    • An overview of statistics about factions involved in faction warfare
    • Ownership of faction warfare systems
    • Data about which NPC factions are at war
  • Industry
    • List character industry jobs
    • Character mining ledger
    • Moon extraction timers
    • Corporation mining observers
    • Observed corporation mining
    • List corporation industry jobs
    • List industry facilities
    • List solar system cost indices
  • Killmails
    • Get a character's recent kills and losses
    • Get a corporation's recent kills and losses
    • Get a single killmail
  • Location
    • Get character location
    • Get character online
    • Get current ship
  • Loyalty
    • Get loyalty points
    • List loyalty store offers
  • Mail
    • Return mail headers
      GET
    • Send a new mail
      POST
    • Get mail labels and unread counts
      GET
    • Create a mail label
      POST
    • Delete a mail label
      DELETE
    • Return mailing list subscriptions
      GET
    • Delete a mail
      DELETE
    • Return a mail
      GET
    • Update metadata about a mail
      PUT
  • Opportunities
    • Get a character's completed tasks
    • Get opportunities groups
    • Get opportunities group
    • Get opportunities tasks
    • Get opportunities task
  • Market
    • List open orders from a character
    • List historical orders by a character
    • List open orders from a corporation
    • List historical orders from a corporation
    • Get item groups
    • Get item group information
    • List market prices
    • List orders in a structure
    • List historical market statistics in a region
    • List orders in a region
    • List type IDs relevant to a market
  • Planetary Interaction
    • Get colonies
    • Get colony layout
    • List corporation customs offices
    • Get schematic information
  • Search
    • Search on a string
    • Search on a string
  • Wallet
    • Get a character's wallet balance
    • Get character wallet journal
    • Get wallet transactions
    • Returns a corporation's wallet balance
    • Get corporation wallet journal
    • Get corporation wallet transactions
  • Corporation
    • Get npc corporations
    • Get corporation information
    • Get alliance history
    • Get corporation blueprints
    • Get all corporation ALSC logs
    • Get corporation divisions
    • Get corporation facilities
    • Get corporation icon
    • Get corporation medals
    • Get corporation issued medals
    • Get corporation members
    • Get corporation member limit
    • Get corporation's members' titles
    • Track corporation members
    • Get corporation member roles
    • Get corporation member roles history
    • Get corporation shareholders
    • Get corporation standings
    • Get corporation starbases (POSes)
    • Get starbase (POS) detail
    • Get corporation structures
    • Get corporation titles
  • Dogma
    • Get attributes
    • Get attribute information
    • Get dynamic item information
    • Get effects
    • Get effect information
  • Incursions
    • List incursions
  • Insurance
    • List insurance levels
  • Routes
    • Get route
  • Sovereignty
    • List sovereignty campaigns
    • List sovereignty of systems
    • List sovereignty structures
  • Status
    • Retrieve the uptime and player counts
  • User Interface
    • Set Autopilot Waypoint
    • Open Contract Window
    • Open Information Window
    • Open Market Details
    • Open New Mail Window
  • Universe
    • Get ancestries
    • Get asteroid belt information
    • Get bloodlines
    • Get item categories
    • Get item category information
    • Get constellations
    • Get constellation information
    • Get factions
    • Get graphics
    • Get graphic information
    • Get item groups
    • Get item group information
    • Bulk names to IDs
    • Get moon information
    • Get names and categories for a set of ID's
    • Get planet information
    • Get character races
    • Get regions
    • Get region information
    • Get stargate information
    • Get star information
    • Get station information
    • List all public structures
    • Get structure information
    • Get system jumps
    • Get system kills
    • Get solar systems
    • Get solar system information
    • Get types
    • Get type information
  • Wars
    • List wars
    • Get war information
    • List kills for a war
  1. Mail

Return a mail

GET
/characters/{character_id}/mail/{mail_id}/
Return the contents of an EVE mail
Alternate route: /dev/characters/{character_id}/mail/{mail_id}/
Alternate route: /legacy/characters/{character_id}/mail/{mail_id}/
Alternate route: /v1/characters/{character_id}/mail/{mail_id}/
This route is cached for up to 30 seconds
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://esi.evetech.net/latest/characters//mail//'
Response Response Example
200 - response
{
    "body": "blah blah blah",
    "from": 90000001,
    "labels": [
        2,
        32
    ],
    "read": true,
    "subject": "test",
    "timestamp": "2023-08-15T09:13:17.861Z"
}

Request

Path Params
character_id
integer 
required
An EVE character ID
mail_id
integer 
required
An EVE mail 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

🟢200Contents of a mail
application/json
Body
200 ok object
body
string 
get_characters_character_id_mail_mail_id_body
optional
Mail's body
from
integer <int32>
get_characters_character_id_mail_mail_id_from
optional
From whom the mail was sent
labels
array[integer <int32>]
get_characters_character_id_mail_mail_id_labels
optional
Labels attached to the mail
<= 25 items
read
boolean 
get_characters_character_id_mail_mail_id_read
optional
Whether the mail is flagged as read
recipients
array[object (get_characters_character_id_mail_mail_id_recipient) {2}] 
get_characters_character_id_mail_mail_id_recipients
optional
Recipients of the mail
>= 1 items<= 52 items
recipient_id
integer <int32>
get_characters_character_id_mail_mail_id_recipient_id
required
recipient_id integer
recipient_type
enum<string> 
get_characters_character_id_mail_mail_id_recipient_type
required
recipient_type string
Allowed values:
alliancecharactercorporationmailing_list
subject
string 
get_characters_character_id_mail_mail_id_subject
optional
Mail subject
timestamp
string <date-time>
get_characters_character_id_mail_mail_id_timestamp
optional
When the mail was sent
🔵304Not modified
🟠400Bad request
🟠401Unauthorized
🟠403Forbidden
🟠404Mail not found
🟠420Error limited
🔴500Internal server error
🔴503Service unavailable
🔴504Gateway timeout
Modified at 2023-08-15 09:13:25
Previous
Delete a mail
Next
Update metadata about a mail
Built with