Skip to main content

WhatsApp Cloud API - Media Download API | Developer Documentation

WhatsApp Cloud API - Media Download API

Copy for LLM
Version
Download media files using URLs obtained from media retrieval endpoints.
Returns binary media content with appropriate MIME type headers.
Media URLs expire after 5 minutes and must be re-retrieved if expired.

Base URL

https://graph.facebook.com

Endpoints

GET /{Version}/{Media-URL}

Download media files using URLs obtained from media retrieval endpoints.
Requires User Access Token with whatsapp_business_messaging permission.
Media URLs expire after 5 minutes and must be re-retrieved if expired.
Returns binary content with appropriate MIME type headers.

Request Syntax

GET /{Version}/{Media-URL}
Try it
Select language
curl--requestGET \
--url'https://graph.facebook.com/{Version}/{Media-URL}' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code
{
"Download Media": {
"value": ""
  }
}
Header Parameters
User-Agentstring
The user agent string identifying the client software making the request.
Authorizationstring·required
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Path Parameters
Versionstring·required
Media-URLstring·required
Responses
Download media files using URLs obtained from media retrieval endpoints.
Requires User Access Token with whatsapp_business_messaging permission.
Media URLs expire after 5 minutes and must be re-retrieved if expired.
Returns binary content with appropriate MIME type headers.
200
Download Media
Content Type: text/plain
Select language
curl--requestGET \
--url'https://graph.facebook.com/{Version}/{Media-URL}' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code
{
"Download Media": {
"value": ""
  }
}

Authentication

Scheme
Type
Location
bearerAuth
HTTP Bearer
Header: Authorization

Usage Examples

bearerAuth:
Include Authorization: Bearer your-token-here in request headers

Global Authentication Requirements

All endpoints require:
bearerAuth
Back to top