Retrieve a Message

    Retrieves a Message Detail Record (MDR).

    API Endpoint

    GET https://api.plivo.com/v1/Account/{auth_id}/Message/{message_uuid}/

    Arguments

    No arguments need to be passed.

    Returns

    This API call returns the Message Detail Record for the message identified by the message_uuid specified in the request URL.

    Response

    HTTP Status Code: 200

    {
        "api_id": "85a704c8-e47a-11eb-9a69-0242ac110004",
        "carrier_fees": "0.00000",
        "error_code": "000",
        "from_number": "17087654321",
        "mcc": "312",
        "message_direction": "outbound",
        "message_state": "delivered",
        "message_time": "2021-07-13 13:04:06.799021+05:30",
        "message_type": "sms",
        "message_uuid": "b48d95dc-e3ac-11eb-a9c2-0242ac110005",
        "mnc": "650",
        "powerpack_id": "1d5f3dd8-b207-4738-b59f-3c2ac7d3461c",
        "resource_uri": "/v1/Account/{auth_id}/Message/b48d95dc-e3ac-11eb-a9c2-0242ac110005/",
        "to_number": "12401234567",
        "total_amount": "0.00140",
        "total_rate": "0.00140",
        "units": 1
    }
    

    Example Request

    1
    2
    3
    4
    5
    
    import plivo
    
    client = plivo.RestClient('<auth_id>','<auth_token>')
    response = client.messages.get(message_uuid='your_message_uuid',)
    print(response)
    
    1
    2
    3
    4
    5
    6
    7
    8
    
    require "rubygems"
    require "plivo"
    
    include Plivo
    
    api = RestClient.new("<auth_id>","<auth_token>")
    response = api.messages.get("your_message_uuid")
    puts response
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    
    var plivo = require('plivo');
    
    (function main() {
        'use strict';
        var client = new plivo.Client("<auth_id>","<auth_token>");
        client.messages.get("your_message_uuid",
      ).then(function (response) {
        console.log(response);
        //Prints only the message_uuid
        console.log(response.messageUuid);
      },);
    })();
    
    1
    2
    3
    4
    5
    6
    7
    8
    
    <?php
    require 'vendor/autoload.php';
    use Plivo\RestClient;
    
    $client = new RestClient("<auth_id>","<auth_token>");
    $response = $client->messages->get('your_message_uuid');
    print_r($response);
    ?>
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    
    import java.io.IOException;
    import com.plivo.api.Plivo;
    import com.plivo.api.exceptions.PlivoRestException;
    import com.plivo.api.models.message.Message;
    
    class MessageGet
    {
        public static void main(String [] args)
        {
            Plivo.init("auth_id", "auth_token");
            try
            {
                Message response = Message.getter("your_message_uuid")
                        .get();
    
                System.out.println(response);
    
            }
            catch (PlivoRestException | IOException e)
            {
                e.printStackTrace();
            }
        }
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    
    using System;
    using Plivo;
    using Plivo.Exception;
    
    namespace PlivoExamples
    {
        internal class Program
        {
            public static void Main(string[] args)
            {
                var api = new PlivoApi("<auth_id>","<auth_token>");
                    var response = api.Message.Get(
                        messageUuid: "your_message_uuid"
                    );
                    Console.WriteLine(response);
            }
        }
    }
    
    1
    2
    
    curl -i --user auth_id:auth_token \
        https://api.plivo.com/v1/Account/{auth_id}/Message/{message_uuid}/
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    
    package main
    
    import "fmt"
    import "github.com/plivo/plivo-go"
    
    func main() {
    	client, err := plivo.NewClient("<auth_id>","<auth_token>", &plivo.ClientOptions{})
    	if err != nil {
    		panic(err)
    	}
    	response, err := client.Messages.Get("your_message_uuid",)
    	if err != nil {
    		panic(err)
    	}
    	fmt.Printf("Response: %#v\n", response)
    }