Surge home page
SupportDashboard
Surge

Get attachment

GET https://api.surge.app/attachments/{attachment_id}

Returns metadata for an MMS attachment — content type, size, and a URL you can use to fetch the file via Get attachment file.

Note

This endpoint is currently not exposed in the published OpenAPI spec, so this page does not render an interactive playground. The endpoint itself is live; the docs for it are kept here so you can find the URL and behaviour when working with message.received payloads that include attachments.

Path parameters

NameTypeDescription
attachment_idstringThe attachment ID, e.g. att_01jbwyqj7rejzat7pq03r7fgmf

Response

{
  "id": "att_01jbwyqj7rejzat7pq03r7fgmf",
  "type": "image",
  "url": "https://api.surge.app/attachments/att_01jbwyqj7rejzat7pq03r7fgmf/file"
}

The url field points at Get attachment file — call that endpoint to download the underlying media.