# Apiosk Gateway - Twilio Messages List

> Apiosk Gateway - Twilio Messages List is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.125/call, status down (last checked 2026-09-15).

Retrieves a paginated list of Twilio SMS/MMS messages sent or received on an account via the Apiosk gateway

## Facts

- Endpoint: GET https://gateway.apiosk.com/twilio/messages
- Price: $0.125/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apiosk-gateway-twilio-messages-list-efa17c9d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vWYV-dZ0WivGi5nDzGy5h

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability apiosk-gateway-twilio-messages-list-efa17c9d
```

Example prompt: Pull the latest messages from my Twilio account and show me their delivery statuses, who they were sent to, and any error codes — I want to see the most recent 2 messages from the gateway.apiosk.com Twilio endpoint.

## When to prefer this

Use this endpoint when you need to retrieve and audit historical or recent SMS/MMS message records from a Twilio account without setting up your own Twilio credentials — the Apiosk gateway abstracts authentication and bills per call via USDC micropayment. Prefer this over direct Twilio API calls when operating in a crypto-native or agent context where x402 payment is the mechanism.

## Known failure modes

- Invalid or missing authentication credentials returns 401 Unauthorized
- Twilio account SID not found returns 404
- Rate limiting by Twilio API returns 429 Too Many Requests
- Network timeout connecting to Twilio backend
- Payment not completed via x402 protocol returns 402 Payment Required
- Invalid pagination parameters return empty or malformed response

## How this service works

API call to twilio

## Output

A paginated JSON object containing a list of Twilio message records, each including message SID, body text, sender/recipient phone numbers, delivery status (e.g. 'failed', 'delivered'), error codes, timestamps, price, direction (outbound-api), number of media attachments, and subresource URIs for media and feedback. Also includes pagination metadata such as page, page size, start, end, and next_page_uri.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "end": 1,
 "uri": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages.json?PageSize=2&Page=0",
 "page": 0,
 "start": 0,
 "messages": [
  {
   "to": "+31612345678",
   "sid": "SM8e468c4d9a58f3d996f54b9cfbe1f727",
   "uri": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages/SM8e468c4d9a58f3d996f54b9cfbe1f727.json",
   "body": "Apiosk test",
   "from": "+15705299789",
   "price": "-0.00100",
   "status": "failed",
   "date_sent": "Tue, 23 Jun 2026 15:36:17 +0000",
   "direction": "outbound-api",
   "num_media": "0",
   "error_code": 21608,
   "price_unit": "USD",
   "account_sid": "AC8d83a5a8d9fbb3c916c434b6694472c9",
   "api_version": "2010-04-01",
   "date_created": "Tue, 23 Jun 2026 15:36:17 +0000",
   "date_updated": "Tue, 23 Jun 2026 15:36:17 +0000",
   "num_segments": "1",
   "error_message": null,
   "subresource_uris": {
    "media": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages/SM8e468c4d9a58f3d996f54b9cfbe1f727/Media.json",
    "feedback": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages/SM8e468c4d9a58f3d996f54b9cfbe1f727/Feedback.json"
   },
   "messaging_service_sid": null
  },
  {
   "to": "+15005550006",
   "sid": "SM2d4864f6953ab71403c597eb06023a99",
   "uri": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages/SM2d4864f6953ab71403c597eb06023a99.json",
   "body": "Apiosk health check",
   "from": "+15705299789",
   "price": null,
   "status": "failed",
   "date_sent": "Tue, 23 Jun 2026 15:36:07 +0000",
   "direction": "outbound-api",
   "num_media": "0",
   "error_code": 21408,
   "price_unit": "USD",
   "account_sid": "AC8d83a5a8d9fbb3c916c434b6694472c9",
   "api_version": "2010-04-01",
   "date_created": "Tue, 23 Jun 2026 15:36:07 +0000",
   "date_updated": "Tue, 23 Jun 2026 15:36:07 +0000",
   "num_segments": "1",
   "error_message": null,
   "subresource_uris": {
    "media": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages/SM2d4864f6953ab71403c597eb06023a99/Media.json",
    "feedback": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages/SM2d4864f6953ab71403c597eb06023a99/Feedback.json"
   },
   "messaging_service_sid": null
  }
 ],
 "page_size": 2,
 "next_page_uri": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages.json?PageSize=2&PageToken=PASM2d4864f6953ab71403c597eb06023a99&Page=1",
 "first_page_uri": "/2010-04-01/Accounts/AC8d83a5a8d9fbb3c916c434b6694472c9/Messages.json?PageSize=2&Page=0",
 "previous_page_ur
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apiosk-gateway-twilio-messages-list-efa17c9d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)