Email API Pricing Sign in

An email's status and each recipient's

GEThttps://api.torvathmail.com/v1/emails/{id}

Emails can be looked up for 30 days after sending, or 90 on the Business plan.

Path parameters

idstringrequired

Response

idstringrequired
fromstringrequired
toarray of stringsrequired
ccarray of stringsrequired
bccarray of stringsrequired
subjectstringrequired
tagsarray of stringsrequired
metadataobjectrequiredstring values
createdAtintegerrequired
Milliseconds since 1970
statusstringrequired
One ofqueuedsentfailed
recipientsarray of objectsrequired
Fields inside recipients
- addressstringrequired
- statestringrequired
  One ofqueuedsentdeliveredbouncedfailed
- categorystringoptional
- reasonstringoptional
- titlestringoptional
- diagnosticstring or nulloptional
- atintegeroptional

Status codes

200
The email
401
No API key, or it isn't valid or was revoked.unauthorized
404
Nothing with that id or name.not_foundtemplate_not_found

Refusals share one shape. See errors.

Recipient states

state	Meaning
`queued`	Waiting to be sent.
`sent`	Handed to the receiving side.
`delivered`	Accepted by the recipient's mail server.
`bounced`	Refused by the recipient's server. category, reason, title and diagnostic say why.
`failed`	Couldn't be sent after every retry.

Request

curl https://api.torvathmail.com/v1/emails/em_7Kq2xY9pLm3nB8vR \
  -H "Authorization: Bearer $TORVATH_API_KEY"

Response

{
  "id": "em_7Kq2xY9pLm3nB8vR",
  "from": "billing@yourcompany.in",
  "to": ["customer@example.com"],
  "cc": [],
  "bcc": [],
  "subject": "Invoice 1042",
  "tags": ["invoice"],
  "metadata": { "invoice": "1042" },
  "createdAt": 1794470400000,
  "status": "sent",
  "recipients": [
    { "address": "customer@example.com", "state": "delivered", "at": 1794470403120 }
  ]
}

PreviousSend an email Next Fetch events

© 2026 Torvath. Questions? support@torvathmail.com