History

This API returns reports of messages sent across all channels (sms, voice, email, whatsapp). Reports can either display all messages on Termii or a single message.

Endpoint : https://BASE_URL/api/sms/inbox?api_key=YourAPIKey

Request Type : GET

You can query a single message by adding


message_id

as query param and passing the message_id as value.Find the Message ID in the JSON response of


Send Message Endpoint

All reports on your account will be returned as response if the


message_id

is not present in the request.

Sample Response - 200 OK

   [
      {
        "receiver": "2347065250817",
        "message": "55675",
        "amount": 1.0,
        "reroute": 0,
        "status": "Delivered",
        "sms_type": "voice",
        "send_by": "api",
        "message_id": "3017545719517588296261695",
        "created_at": "2025-08-07 14:05:53"
      },
      {
        "receiver": "2347065250817",
        "message": "786101",
        "amount": 1.0,
        "reroute": 0,
        "status": "Failed",
        "sms_type": "voice",
        "send_by": "api",
        "message_id": "3017545716011763238246705",
        "created_at": "2025-08-07 14:00:03"
      },
      {
        "sender": "Great",
        "receiver": "2347065250817",
        "message": "Your pin is 356802",
        "amount": 1.0,
        "reroute": 0,
        "status": "Delivered",
        "sms_type": "generic",
        "send_by": "api",
        "message_id": "3017545711235443752697757",
        "created_at": "2025-08-07 13:52:04"
      },
      {
        "sender": "Great",
        "receiver": "2347065250817",
        "message": "Your pin is 895912",
        "amount": 1.0,
        "reroute": 0,
        "status": "Delivered",
        "sms_type": "generic",
        "send_by": "api",
        "message_id": "3017545711013402629046482",
        "created_at": "2025-08-07 13:51:41"
      }
]