> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.usglobalmail.com/api/api-reference/mails/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.usglobalmail.com/_mcp/server.

# Mails

> Official documentation for the USGM API — REST endpoints, SDKs (TypeScript, Python, PHP, Go), an MCP server, and guides for your US Global Mail mailbox.


## API Docs

- Mails [List mail items](https://docs.usglobalmail.com/api/api-reference/mails/list.md)
- Mails [Get single mail](https://docs.usglobalmail.com/api/api-reference/mails/get.md)
- Mails [Update mail item](https://docs.usglobalmail.com/api/api-reference/mails/update.md)
- Mails [Archive mail item](https://docs.usglobalmail.com/api/api-reference/mails/archive.md)
- Mails [Unarchive mail item](https://docs.usglobalmail.com/api/api-reference/mails/unarchive.md)
- Mails [Discard mail item](https://docs.usglobalmail.com/api/api-reference/mails/discard.md)
- Mails [Undiscard mail item](https://docs.usglobalmail.com/api/api-reference/mails/undiscard.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.usglobalmail.com/api/api-reference/mails/openapi.json)
- [OpenAPI YAML](https://docs.usglobalmail.com/api/api-reference/mails/openapi.yaml)