Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu

List attachments

The attachments and inline parts of one received email, each with a signed download link valid for one hour; all of them unless limit is given. Needs a full access key. The links of an email that carries malware answer 410.

GET/emails/receiving/{email_id}/attachments
Autorisation
AuthorizationJeton Bearer · headerrequis

A BillionSend API key (bs_…).

Paramètres de chemin
email_idstring<uuid>requis
Paramètres de requête
limitinteger

Page size, 1-100 (default 20)

min 1 · max 100
afterstring<uuid>

Cursor: id of the last item of the current page; returns the next page. Must be an id this list returned; there is no sentinel value.

beforestring<uuid>

Cursor: id of the first item of the current page; returns the previous page; same rule as after.

Réponses
200

Attachments

objectstringrequis
Valeurs autorisées :list
has_morebooleanrequis
dataobject[]requis
Afficher les propriétés
Tableau de object
idstring<uuid>requis
filenamestring
sizeintegerrequis
content_typestringrequis
content_dispositionstringrequis
Valeurs autorisées :inlineattachment
content_idstring
download_urlstringrequis

Signed link to the file's bytes, valid for one hour; it needs no API key

expires_atstringrequis
401

Missing, malformed, unknown or revoked API key

statusCodenumberrequis
namestringrequis
messagestringrequis
403

Restricted API key

statusCodenumberrequis
namestringrequis
messagestringrequis
404

Not found

statusCodenumberrequis
namestringrequis
messagestringrequis
422

Validation error

statusCodenumberrequis
namestringrequis
messagestringrequis
429

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

statusCodenumberrequis
namestringrequis
messagestringrequis
Essayer
Serveur
Autorisation
Paramètres
Requête
curl -X GET 'https://api.billionsend.com/emails/receiving/497f6eca-6276-4993-bfeb-53cbbbba6f08/attachments' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Réponse
{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "filename": "string",
      "size": 0,
      "content_type": "string",
      "content_disposition": "inline",
      "content_id": "string",
      "download_url": "string",
      "expires_at": "string"
    }
  ]
}

Cette page vous a-t-elle été utile ?