List SMS numbers

The workspace's SMS numbers with their readiness, and its provider accounts by a masked identifier. Never returns a credential.

GEThttps://app.trygtm.com/api/v1/sms/senders
Scope
read

Request

curl https://app.trygtm.com/api/v1/sms/senders \
  -H "Authorization: Bearer $TRYGTM_API_KEY"

Response

{
  "data": {
    "enabled": true,
    "configured": true,
    "setup_message": null,
    "senders": [
      {
        "connection_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
        "sender_name": "Acme",
        "registration_status": "approved",
        "registration_detail": "Ready to send.",
        "registration_checked_at": "2026-09-21T08:00:00.000Z",
        "max_segments": 10,
        "created_at": "2026-09-01T12:00:00.000Z",
        "channel_connections": {
          "handle": "+14155550123",
          "provider": "twilio",
          "status": "connected",
          "daily_limit": 100,
          "sent_today": 12,
          "sent_today_date": "2026-09-22",
          "disconnected_at": null
        }
      }
    ],
    "accounts": [
      {
        "id": "0a1b2c3d-4e5f-4a6b-8c7d-8e9f0a1b2c3d",
        "provider": "twilio",
        "label": "AC••••1234",
        "status": "connected",
        "terms_accepted_at": "2026-09-01T11:58:00.000Z"
      }
    ],
    "providers": []
  }
}

Was this page helpful?