Skip to main content
GET
/
v1
/
organization
/
sms
/
messages
cURL
curl --request GET \
  --url https://9dc2c77e6dbf.ngrok-free.app/v1/organization/sms/messages \
  --header 'Authorization: Bearer <token>'
{
  "messages": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "systemPhoneNumberId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "systemPhoneNumber": "<string>",
      "fromPhoneNumber": "<string>",
      "toIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "text": "<string>",
      "subject": "<string>",
      "type": "SMS",
      "transport": "sms",
      "direction": "INBOUND",
      "receivedAt": "2023-11-07T05:31:56Z",
      "sentAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "recipients": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "phoneNumber": "<string>",
          "status": "QUEUED",
          "carrier": "<string>",
          "lineType": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ],
  "nextCursor": {
    "createdAt": "2024-01-15T10:30:00.000Z",
    "id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"
  },
  "totalCount": 100
}

Authorizations

Authorization
string
header
required

Admin API key (format: sk_admin_*) for organization-level operations

Query Parameters

limit
string

Maximum number of items to return (default: 20)

Example:

"20"

cursorCreatedAt
string

Cursor createdAt timestamp (ISO string) for pagination

Example:

"2024-01-15T10:30:00.000Z"

cursorId
string<uuid>

Cursor ID for pagination

Example:

"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"

offset
string

Offset for pagination (fallback when cursor is not available)

Example:

"40"

direction
enum<string>
Available options:
INBOUND,
OUTBOUND
appId
string<uuid>

Response

200 - application/json

List all SMS messages

messages
object[]
required
nextCursor
object
required

Cursor for the next page, or null if no more results

totalCount
integer
required

Total number of items matching the query

Example:

100