cURL

curl -X GET 'https://api.telegent.com/v1.0/message/filter?PhoneNumber=%2B11234567890&Page=1&Results=25' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "Messages": [
    {
      "MessageId": "MSG-abc123",
      "From": "+11234567890",
      "To": "+10987654321",
      "Body": "Hello world",
      "Direction": "outbound",
      "Status": "delivered",
      "CreatedAt": "2025-05-01T12:00:00Z"
    }
  ],
  "Page": 1,
  "Results": 25,
  "Total": 100
}

Message

Filter Messages

Retrieve messages filtered by phone number with pagination support. Returns a list of inbound and outbound messages for a specific number. Similar to Message Search but returns the full filtered message list.

What this does: Returns a paginated list of messages for the given phone number. Similar to Message Search but designed for simple phone-number-based filtering. Returns message IDs, bodies, direction, status, and timestamps.

Next steps:

Get full details for a specific message — GET /v1.0/message/details
Send a message — POST /v1.0/message/outbound

GET

v1.0

message

filter

cURL

curl -X GET 'https://api.telegent.com/v1.0/message/filter?PhoneNumber=%2B11234567890&Page=1&Results=25' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "Messages": [
    {
      "MessageId": "MSG-abc123",
      "From": "+11234567890",
      "To": "+10987654321",
      "Body": "Hello world",
      "Direction": "outbound",
      "Status": "delivered",
      "CreatedAt": "2025-05-01T12:00:00Z"
    }
  ],
  "Page": 1,
  "Results": 25,
  "Total": 100
}

Query Parameters

PhoneNumber

string

The phone number to filter messages for (E.164 format)

Page

integer

Page number for pagination

Results

integer

Number of results per page

Response

Success — returns a paginated list of filtered messages

The response is of type object.

Message Search Delete Message Route

⌘I