GET/api/test-emailsAuthenticated

List emails captured by the test-database transport

Lists emails 'sent' through the fake test-database-transport, newest first. Attachments are listed without their content; read an email by ID for that. Intended for E2E tests verifying the full /api/send flow without real delivery.

operationId listTestEmailsTest Emails

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials: Mail-server API key (Bearer)Authorization: Bearer <token>
Access token (Bearer)Authorization: Bearer <JWT>
Access token (cookie)cookie "access_token_schemavaults-mail"
Who may call: Any authenticated user
Notes: Access tokens must belong to an admin (other users get 403). Admins may always read. API keys may read only when their transport scope permits the test-database transport (zero transport-scope entries = unrestricted), the same rule /api/send applies to sending through it.

Query parameters

Name	Type	Description
limit	integer	Page size (default 50, max 200).
offset	integer \| null	Rows to skip, for paging (default 0).

Responses

application/json

Property	Type	Description
success*	true
data*	TestEmailSummary[]
test_email_id*	string (uuid)
from_address*	string	The `from` the send was dispatched with (bare address or `Display Name <address>` form).
to_addresses*	string[]	Recipient addresses, after any mailing-list expansion. minItems: 1
cc_addresses*	string[]
bcc_addresses*	string[]
reply_to_addresses*	string[]
subject*	string
html*	string \| null \| null	Rendered HTML body (templates are rendered before the transport runs), or null for text-only sends.
text*	string \| null \| null
created_at*	number	Unix epoch milliseconds when the fake send was stored. minimum: 0
attachments*	TestEmailAttachmentMetadata[]	The email's attachments without their content, in the order they were sent (empty when it had none). Read the email by ID for the content.
filename*	string
content_type*	string \| null \| null	The MIME type exactly as the sender passed it, or null when it was omitted (the real transports derive it from the filename).
content_id*	string \| null \| null	The Content-ID of an inline attachment (referenced from the HTML as `cid:<content_id>`), or null for a regular attachment.
size_bytes*	integer	Decoded size of the attachment, in bytes. minimum: 0

JSONExample

"success"true

"data"

"test_email_id""123e4567-e89b-12d3-a456-426614174000"

"from_address""Example <noreply@example.com>"

"to_addresses"

"cc_addresses"

"bcc_addresses"

"reply_to_addresses"

"subject""string"

"html""string"

"text""string"

"created_at"1.5

"attachments"

Example request

bashcurl

curl -X GET 'https://mail.schemavaults.com/api/test-emails' \
  -H 'Authorization: Bearer <access_token>'

Name

Type

Description

limit

integer

Page size (default 50, max 200).

offset

integer | null

Rows to skip, for paging (default 0).

Responses

application/json

Property	Type	Description
success*	true
data*	TestEmailSummary[]
test_email_id*	string (uuid)
from_address*	string	The `from` the send was dispatched with (bare address or `Display Name <address>` form).
to_addresses*	string[]	Recipient addresses, after any mailing-list expansion. minItems: 1
cc_addresses*	string[]
bcc_addresses*	string[]
reply_to_addresses*	string[]
subject*	string
html*	string \| null \| null	Rendered HTML body (templates are rendered before the transport runs), or null for text-only sends.
text*	string \| null \| null
created_at*	number	Unix epoch milliseconds when the fake send was stored. minimum: 0
attachments*	TestEmailAttachmentMetadata[]	The email's attachments without their content, in the order they were sent (empty when it had none). Read the email by ID for the content.
filename*	string
content_type*	string \| null \| null	The MIME type exactly as the sender passed it, or null when it was omitted (the real transports derive it from the filename).
content_id*	string \| null \| null	The Content-ID of an inline attachment (referenced from the HTML as `cid:<content_id>`), or null for a regular attachment.
size_bytes*	integer	Decoded size of the attachment, in bytes. minimum: 0

JSONExample

"success"true

"data"

"test_email_id""123e4567-e89b-12d3-a456-426614174000"

"from_address""Example <noreply@example.com>"

"to_addresses"

"cc_addresses"

"bcc_addresses"

"reply_to_addresses"

"subject""string"

"html""string"

"text""string"

"created_at"1.5

"attachments"

SchemaVaults

API Reference

List emails captured by the test-database transport

Authentication & permissionsAuthenticated

Query parameters

Responses

Example request

SchemaVaults

API Reference

List emails captured by the test-database transport

Authentication & permissionsAuthenticated

Query parameters

Responses

Example request

Authentication & permissionsAuthenticated

Query parameters

Responses

200The captured test emails, newest first.

400The path parameters, query string, headers or body failed validation.

401No credential was presented, or the presented credential is invalid, expired or revoked.

403The API key's transport scope does not permit the test-database transport.

500Failed to list test emails.

Example request

Authentication & permissionsAuthenticated

Query parameters

Responses

200The captured test emails, newest first.

400The path parameters, query string, headers or body failed validation.

401No credential was presented, or the presented credential is invalid, expired or revoked.

403The API key's transport scope does not permit the test-database transport.

500Failed to list test emails.

Example request