MEmeta
Media

Retrieve Media URL

To retrieve your media’s URL, make a GET call to /{{Media-ID}}. Use the returned URL to download the media file. Note that clicking this URL (i.e. performing a generic GET) will not return the media; you must include an access token. For more information, see Download Media.

You can also use the optional query ?phone_number_id for Retrieve Media URL and Delete Media. This parameter checks to make sure the media belongs to the phone number before retrieval or deletion.

Response

A successful response includes an object with a media URL. The URL is only valid for 5 minutes. To use this URL, see Download Media.

get/{Version}/{Media-ID}

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Media-ID}
  • Auth
    HTTP bearer

Query parameters

phone_number_idstring
Example:<PHONE_NUMBER_ID>

Specifies that this action only be performed if the media belongs to the provided phone number.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Response

Retrieve Media URL

file_sizestring
idstring
messaging_productstring
mime_typestring
sha256string
urlstring

Example response

{
  "file_size": "303833",
  "id": "2621233374848975",
  "messaging_product": "whatsapp",
  "mime_type": "image/jpeg",
  "sha256": "<HASH>",
  "url": "<URL>"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.