# VIETXF

> Free temporary/disposable email inbox service. This file describes the
> public HTTP API for programmatic and AI-agent use.

Base URL: https://vietxf.com

## API

GET /api/domains
    List domains available for creating a temporary mailbox.

GET /api/inbox/{email}
    List messages in a mailbox. {email} is a full address on one of the domains from /api/domains (e.g. abc123@example.com). No account or authentication is required for mailboxes on this instance's free system domains.

GET /api/inbox/{email}/head
    Lightweight summary of a mailbox (message count, unread count) for polling without paginating the full message list.

GET /api/inbox/{email}/stream
    Server-Sent Events stream of new mail arriving in a mailbox.

GET /api/message/{id}
    Fetch one message's full body by id. The id comes from a message listed by GET /api/inbox/{email}.

GET /api/stats
    Public, best-effort usage statistics for this instance.

GET /api/public-config
    Public, non-sensitive site configuration (site display name).

## Authentication

The endpoints above work anonymously for mailboxes on this instance's free
system domains. Where a signed-in account is involved, send a bearer token
via `Authorization: Bearer <jwt>` or an API key via the `X-API-Key` header.

## See also

https://vietxf.com/robots.txt
https://vietxf.com/sitemap.xml