Get a brand document download URL

Get a brand document download URL

GET/api/v1/sms/brands/{id}/documents/{documentId}/url

GET /sms/brands/{id}/documents/{documentId}/url
curl -X GET 'https://www.unitpost.com/api/v1/sms/brands/sms_123/documents/documentId_123/url' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'
Response · 200
{
  "object": "sms_brand_document_url",
  "url": "https://example.com",
  "expires_at": "2026-01-01T00:00:00.000Z"
}

A 5-minute signed link to one document's file. A document that identifies a person (signatory_id, emirates_id, signatory_passport) needs sms:manage. A text document has no file (404). Requires the sms:read capability.

Parameters2 fields
FieldTypeDescription
idrequiredstring · path—
documentIdrequiredstring · path—
Response · 200 fields3 fields
FieldTypeDescription
objectrequiredstring—
urlrequiredstringA signed link to the file. It is a credential: fetch it now, don't share or log it.
expires_atrequiredstringThe link stops working at this time (5 minutes).
200401403404422503

Search docs and guides

Search the docs and product guides.