List Messages (Telnyx)
phone.telnyx.listRead-onlyIdempotent
Retrieve recent Telnyx messages with filters for direction, date, and limit. Returns message ID, sender, receiver, text, status, timestamp, and cost.
Instructions
List recent Telnyx messages with optional filters: direction (inbound/outbound), date_from (ISO 8601), and pagination limit (max 100). Returns array of {message_id, from, to, text, status, created_at, cost} (Telnyx)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max number of messages to return per page (default 25, max 100). | |
| direction | No | Filter by message direction: "outbound" (sent by us) or "inbound" (received). | |
| date_from | No | ISO 8601 date — return messages created on or after this date (e.g. "2026-04-26"). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | Tool response payload. Shape varies per tool — consult the tool description and inputSchema. May be an object, array, string, or number depending on the upstream provider response. | |
| error | No | Present only when the call failed. Includes error code, message, request_id, and any provider-specific extras. |