Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Retrieve an email

GET/emails/{id}
Authorization
AuthorizationBearer token · headerrequired

A BillionSend API key (bs_…).

Path parameters
idstring<uuid>required
Responses
200

Email

idstring<uuid>required
fromstringrequired
tostring[]required
ccstring[] | nullrequired
bccstring[] | nullrequired
reply_tostring[] | nullrequired
subjectstringrequired
created_atstringrequired
scheduled_atstring | nullrequired
last_eventstringrequired
objectstringrequired
Allowed:email
htmlstring | nullrequired
textstring | nullrequired
message_idstringrequired
scorenumber | nullrequired
401

Missing, malformed, unknown or revoked API key

statusCodenumberrequired
namestringrequired
messagestringrequired
403

Restricted API key

statusCodenumberrequired
namestringrequired
messagestringrequired
404

Not found

statusCodenumberrequired
namestringrequired
messagestringrequired
429

Over the rate limit (rate_limit_exceeded, with Retry-After)

statusCodenumberrequired
namestringrequired
messagestringrequired
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.billionsend.com/emails/497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "from": "string",
  "to": [
    "string"
  ],
  "cc": [
    "string"
  ],
  "bcc": [
    "string"
  ],
  "reply_to": [
    "string"
  ],
  "subject": "string",
  "created_at": "string",
  "scheduled_at": "string",
  "last_event": "string",
  "object": "email",
  "html": "string",
  "text": "string",
  "message_id": "string",
  "score": 0
}

Was this page helpful?