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

# Changelog

## July 13, 2026

## v1 — US Global Mail API launch

The US Global Mail API is now available.

**Resources**

- **Mail items** — list, fetch, update, archive/unarchive, and discard/undiscard mail.
- **Folders** — list, create, update, and delete folders.
- **Addresses** — list, create, update, delete, and manage default shipping and deposit addresses.
- **Shipments** — list and fetch shipment requests (read-only).

**Platform**

- API-key authentication (`usgmk_live_…` / `usgmk_test_…`) with a full sandbox environment.
- Cursor-based pagination on all list endpoints (`{ data, next_cursor }`).
- RFC 9457 `application/problem+json` errors with a `request_id` on every response.
- Edge rate limiting with `X-RateLimit-*` and `Retry-After` headers.

**Tooling**

- Official SDKs for TypeScript, Python, PHP, and Go.
- An MCP server for AI coding agents.