Fetch Media by Media ID

Read by Media ID for SMSGatewayCenter APIs

Introduction to SMSGatewayCenter APIs

Welcome to SMSGatewayCenter’s API documentation hub! This guide introduces the Read by Media ID API, a key feature in our messaging suite, including SMS API for bulk messaging, WhatsApp Business API for customer engagement, Voice Call API for automated alerts, and Two-Way SMS API for interactive communication. This API supports both POST and GET methods over HTTP, enabling you to fetch a specific media file by its media ID from the WhatsApp Business Cloud API library. Ideal for developers in India, manage your media efficiently with our SMS gateway at unify.smsgatewaycenter.com/signup/!

Use the Read by Media ID API to retrieve details and metadata of a specific media file (e.g., images, videos, documents) uploaded to WhatsApp’s cloud servers, using its unique media ID. This endpoint enhances your WhatsApp Business operations by allowing you to inspect or manage individual media assets for customer communications, with support for secure access and metadata retrieval.

 

API Endpoint

https://unify.smsgateway.center/WAApi/media

 

Required Parameters
KeyValueDescription
Login Credentials (Required)
Authenticate your API request using userid-password or apiKey—choose one method.
useridYour Registered UsernameYour registered username; use if apiKey isn’t provided. Signup for User ID
passwordYour PasswordURL-encoded password (for special characters); use if apiKey isn’t provided. Signup for API Key
Header (optional) Parameters
apiKeyYour unique apiKeyapiKey needs to be sent as HTTP header when you are not using userid-password method. You can avail this from your user control panel and use instead of userid-password HTTP Request parameter. Please do not disclose this to anyone.
Required Parameters
mediaIdintegerEnter your media ID which you wish to download.
outputplain|json|plainValue for response format.System default is plain. If you need responses in json or plain then you have to give value as json or plain.

 

Sample Request Code
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://unify.smsgateway.center/WAApi/media?userid=YourUsername&password=********&output=json&mediaId=1952729834901819105',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Cookie: SERVERID=webC1'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

 

Sample Response Code
{
    "status": "success",
    "mediaList": "[{\"identifier\":\"ImageTesting\",\"creationTime\":1740819997743,\"description\":\"This is test image\",\"mediaType\":\"image\",\"mediaId\":\"7074855483357676350\",\"wabaNumber\":917039670396,\"status\":\"active\"}]",
    "statusCode": "200",
    "reason": "success"
}
Unlock Real-Time Messaging – Integrate Today!

Unlock Real-Time Messaging – Integrate Today!

Try Our API in a Sandbox Environment Before Going Live!

Join Thousands of Developers – Try Our API Now!

Get in touchSign up

Testimonials

Why do Great Businesses Trust SMS Gateway Center?

K

Kurlon IT

2022-08-04

We have tied up with other SMS providers also, but SMS GatewayCenter is quite good. Good Service from the team. We are very happy with the service be it accounts related or technical issue. We always get good response.

I

INOX Air Products

2018-02-09

We have an excellent experience with SMS Gateway Center. The services and support has been of very high standard.

R

Rohit Singh Rawat

2017-06-05

It is the best SMS gateway to send bulk messages. It's the best and easiest way to reach out to your goals... Planning is everything to attain goal and adding SMS Gateway Center in that plan will definitely help in accomplishing goals... Thanks to the developers...

A

Anil Singh

2018-02-09

We have an excellent experience with SMS Gateway Center. The services and support has been of very high standard.