Sample code for 30+ languages & platforms
CkJava Requires Chilkat v11.0.0+

Download the media files from a Twilio MMS

See more Twilio Examples

Supply the Message SID of a received or sent MMS. List its media records, then request each media resource without the .json extension to download the file bytes. Twilio may return a temporary HTTPS download URL. The example uses a separate HTTP client for that URL so the Twilio API key stays with the API host.

Run in an empty output directory. Files are written as mms-media-1.bin, mms-media-2.bin, and so on. The code prints the media SID and MIME type alongside each filename. An empty media list produces a count of zero.

Twilio documentation

Chilkat CkJava Downloads

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Load an API key for the Twilio account from private application configuration.
    CkHttp http = new CkHttp();
    http.put_RequireSslCertVerify(true);
    http.put_BasicAuth(true);
    http.put_Login("YOUR_API_KEY_SID");
    http.put_Password("YOUR_API_KEY_SECRET");

    CkStringBuilder url = new CkStringBuilder();
    url.Append("https://api.twilio.com/2010-04-01/Accounts/");
    url.Append("YOUR_ACCOUNT_SID");
    url.Append("/Messages");
    url.Append("/");
    url.Append("YOUR_MESSAGE_SID");
    url.Append("/Media");
    CkStringBuilder mediaBase = new CkStringBuilder();
    mediaBase.AppendSb(url);
    url.Append(".json");
    //  Handle the API redirect explicitly so a signed download uses no Twilio credentials.
    http.put_FollowRedirects(false);
    CkHttp download = new CkHttp();
    download.put_RequireSslCertVerify(true);
    CkHttpResponse fileResp = new CkHttpResponse();
    CkStringBuilder fileUrl = new CkStringBuilder();
    CkStringBuilder filename = new CkStringBuilder();
    CkStringBuilder mediaSid = new CkStringBuilder();
    int saved = 0;
    CkHttpResponse resp = new CkHttpResponse();
    CkJsonObject reply = new CkJsonObject();

    boolean more = true;
    while ((more == true)) {
        success = http.HttpNoBody("GET",url.getAsString(),resp);
        if (resp.get_StatusCode() == 0) {
            System.out.println("No HTTP response from Twilio.");
            return;
            }

        boolean parsed = reply.Load(resp.bodyStr());
        if ((success != true) || (resp.get_StatusCode() != 200)) {
            System.out.println("Twilio returned HTTP " + resp.get_StatusCode());
            if ((parsed == true) && (reply.JsonTypeOf("code") == 2)) {
                System.out.println("Twilio error: " + reply.IntOf("code") + "  " + reply.stringOf("message"));
                }

            return;
            }

        if (parsed != true) {
            System.out.println("Expected a JSON response from Twilio.");
            return;
            }

        if (reply.JsonTypeOf("media_list") != 4) {
            System.out.println("Expected an array of media items.");
            return;
            }

        int count = reply.SizeOfArray("media_list");
        int i = 0;
        while ((i < count)) {
            reply.put_I(i);
            mediaSid.SetString(reply.stringOf("media_list[i].sid"));
            if (mediaSid.get_Length() == 0) {
                System.out.println("Media item is missing its SID.");
                return;
                }

            fileUrl.SetString(mediaBase.getAsString());
            fileUrl.Append("/");
            fileUrl.AppendSb(mediaSid);
            success = http.HttpNoBody("GET",fileUrl.getAsString(),fileResp);
            if ((fileResp.get_StatusCode() >= 300) && (fileResp.get_StatusCode() < 400)) {
                fileUrl.SetString(fileResp.getHeaderField("Location"));
                if (fileUrl.StartsWith("https://",false) != true) {
                    System.out.println("Expected an HTTPS media download URL.");
                    return;
                    }

                success = download.HttpNoBody("GET",fileUrl.getAsString(),fileResp);
                }

            if ((success != true) || (fileResp.get_StatusCode() != 200)) {
                System.out.println("Media download failed for " + mediaSid.getAsString() + ". HTTP " + fileResp.get_StatusCode());
                return;
                }

            filename.SetString("mms-media-");
            filename.AppendInt(saved+1);
            filename.Append(".bin");
            success = fileResp.SaveBodyBinary(filename.getAsString());
            if (success == false) {
                System.out.println(fileResp.lastErrorText());
                return;
                }

            System.out.println(filename.getAsString() + "  " + mediaSid.getAsString() + "  " + reply.stringOf("media_list[i].content_type"));
            saved = saved+1;
            i = i+1;
            }

        if (reply.IsNullOf("next_page_uri") == true) {
            more = false;
            }
        else {
            url.SetString(reply.stringOf("next_page_uri"));
            if (url.StartsWith("/2010-04-01/Accounts/",true) != true) {
                System.out.println("Expected a Twilio relative next-page URI.");
                return;
                }

            url.Prepend("https://api.twilio.com");
            }

        }

    System.out.println("Media files saved: " + saved);
  }
}