v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1431213151.3 KB

Get a media file from the WhatsApp service. On successful completion the media file is retrieved from Meta and stored in the specified Amazon S3 bucket. Use either <code>destinationS3File</code> or <code>destinationS3PresignedUrl</code> for the destination. If both are used then an <code>InvalidParameterException</code> is returned.

post/v1/whatsapp/media/get

Request body

mediaIdstring required

The unique identifier for the media file.

originationPhoneNumberIdstring required

The unique identifier of the originating phone number for the WhatsApp message media. The phone number identifiers are formatted as <code>phone-number-id-01234567890123456789012345678901</code>. Use <a href="https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetLinkedWhatsAppBusinessAccount.html">GetLinkedWhatsAppBusinessAccount</a> to find a phone number's id.

metadataOnlyboolean

Set to <code>True</code> to get only the metadata for the file.

Response

Success

mimeTypestring

The MIME type of the media.

fileSizeinteger

The size of the media file, in KB.