Skip to main content
GET
/
{media_id}
Get media URL
curl --request GET \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{media_id} \
  --header 'X-API-Key: <api-key>'
{
  "messaging_product": "whatsapp",
  "url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=2621233374848975&ext=1234567890&hash=...",
  "mime_type": "image/jpeg",
  "sha256": "81d3bd8a8db4868c9520ed47186e8b7c5789e61ff79f7f834be6950b808a90d3",
  "file_size": "303833",
  "id": "2621233374848975",
  "download_url": "https://api.kapso.ai/meta/whatsapp/media_download?token=eyJfcmFpbHMiOnsibWVzc2FnZSI6...",
  "download_url_expires_at": "2026-03-13T12:34:56.000Z"
}

Authorizations

​
X-API-Key
string
header
required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Integrations > API keys.

Path Parameters

​
media_id
string
required

Media ID returned from upload

Query Parameters

​
phone_number_id
string
required

Phone number ID that owns this media

Response

Media URL retrieved successfully

​
messaging_product
enum<string>
Available options:
whatsapp
Example:

"whatsapp"

​
id
string

Media ID

Example:

"2621233374848975"

​
url
string<uri>

Temporary download URL (valid for 5 minutes)

Example:

"https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=..."

​
mime_type
string

MIME type

Example:

"image/jpeg"

​
sha256
string

File hash

Example:

"81d3bd8a8db4868c9520ed47186e8b7c5789e61ff79f7f834be6950b808a90d3"

​
file_size
string

File size in bytes (returned as string)

Example:

"303833"

​
download_url
string<uri>

Kapso-hosted authenticated download URL. Valid for 4 minutes. Use this URL to download the media file without needing to pass auth headers — authentication is embedded in the token.

Example:

"https://api.kapso.ai/meta/whatsapp/media_download?token=..."

​
download_url_expires_at
string<date-time>

ISO 8601 expiry timestamp for download_url.

Example:

"2026-03-13T12:34:56.000Z"