Skip to main content
GET
/
v1.0
/
message
/
search
cURL
curl -X GET 'https://api.telegent.com/v1.0/message/search?phoneNumber=%2B18015555555' \
  -H 'Authorization: Bearer YOUR_TOKEN'
{
  "PhoneNumber": "+18015555555",
  "ResultsTotalRecords": 2,
  "ResultsPages": 1,
  "Results": [
    {
      "MessageID": "TMID-00348008102307aT03",
      "Direction": "Inbound",
      "Type": "a2p",
      "CampaignID": "JCID-dsuhofh3882",
      "Cost": "$0.0045",
      "Status": "Received",
      "To": [
        {
          "Number": "+12016093801"
        },
        {
          "Number": "+12232233180"
        }
      ],
      "From": "+18018018011",
      "Owner": "+18018018011",
      "Body": "Hello there!!!",
      "MmsMedia": [
        {
          "MediaUrl": "https://results2.com"
        },
        {
          "MediaUrl": "https://results.com"
        }
      ],
      "MmsBase64": [
        {
          "Base64": "dkjjkdflajdfjo3ji3jjljfkjaskjfad",
          "BaseType": "audio/wav"
        },
        {
          "Base64": "dkjjkdflajdfjo3ji3jjljfkjaskjfad",
          "BaseType": "video/mpg"
        }
      ]
    },
    {
      "MessageID": "TMID-00348008102307aT04",
      "Direction": "Inbound",
      "Type": "a2p",
      "CampaignID": "JCID-dsuhofh3882",
      "Cost": "$0.0045",
      "Status": "Received",
      "To": [
        {
          "Number": "+12016093801"
        },
        {
          "Number": "+12232233180"
        }
      ],
      "From": "+18018018011",
      "Owner": "+18018018011",
      "Body": "Another TEST!!!",
      "MmsMedia": [
        {
          "MediaUrl": "https://results2.com"
        },
        {
          "MediaUrl": "https://results.com"
        }
      ],
      "MmsBase64": [
        {
          "Base64": "dkjjkdflajdfjo3ji3jjljfkjaskjfad",
          "BaseType": "audio/wav"
        },
        {
          "Base64": "dkjjkdflajdfjo3ji3jjljfkjaskjfad",
          "BaseType": "video/mpg"
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.telegent.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Enter the token obtained from the Authentication endpoint

Query Parameters

​
phoneNumber
string

Phone number to search messages for (E.164 format)

Response

200 - application/json

Message Search

The response is of type object.