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 mail headers

GET
/characters/{character_id}/mail/
Mail
Return the 50 most recent mail headers belonging to the character that match the query criteria. Queries can be filtered by label, and last_mail_id can be used to paginate backwards
Alternate route: /dev/characters/{character_id}/mail/
Alternate route: /legacy/characters/{character_id}/mail/
Alternate route: /v1/characters/{character_id}/mail/
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
[
  {
    "from": 90000001,
    "is_read": true,
    "labels": [
      3
    ],
    "mail_id": 7,
    "recipients": [
      {
        "recipient_id": 90000002,
        "recipient_type": "character"
      }
    ],
    "subject": "Title for EVE Mail",
    "timestamp": "2023-08-15T09:13:17.860Z"
  }
]

Request

Path Params
character_id
integer 
required
An EVE character ID
Query Params
datasource
string 
optional
The server name you would like data from
labels
array[string]
optional
Fetch only mails that match one or more of the given labels
last_mail_id
integer 
optional
List only mail with an ID lower than the given ID, if present
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

🟢200The requested mail
application/json
Body
200 ok array
array of:
from
integer <int32>
get_characters_character_id_mail_from
optional
From whom the mail was sent
is_read
boolean 
get_characters_character_id_mail_is_read
optional
is_read boolean
labels
array[integer <int32>]
get_characters_character_id_mail_labels
optional
labels array
<= 25 items
mail_id
integer <int32>
get_characters_character_id_mail_mail_id
optional
mail_id integer
recipients
array[object (get_characters_character_id_mail_recipient) {2}] 
get_characters_character_id_mail_recipients
optional
Recipients of the mail
>= 1 items<= 52 items
recipient_id
integer <int32>
get_characters_character_id_mail_recipient_id
required
recipient_id integer
recipient_type
enum<string> 
get_characters_character_id_mail_recipient_type
required
recipient_type string
Allowed values:
alliancecharactercorporationmailing_list
subject
string 
get_characters_character_id_mail_subject
optional
Mail subject
timestamp
string <date-time>
get_characters_character_id_mail_timestamp
optional
When the mail was sent
🔵304Not modified
🟠400Bad request
🟠401Unauthorized
🟠403Forbidden
🟠420Error limited
🔴500Internal server error
🔴503Service unavailable
🔴504Gateway timeout
Modified at 2023-08-15 09:13:24
Previous
List loyalty store offers
Next
Send a new mail
Built with