Message

Send a single text message (SMS, WhatsApp, or RCS) to one or more recipients, and query its delivery status. Status can be queried up to seven days after sending.

Send a single message

post

Sends a single message to one recipient (to) or a list of recipients (toList). Supported channels: SMS, WhatsApp, RCS.

Note: to and toList are mutually exclusive — passing both returns a validation error.

SMS character limits

A single SMS page holds 160 characters (GSM) or 70 characters (UCS-2). Long messages are split into pages (max. 10). Multi-part pages each lose 7 characters to sequencing data, giving 153 chars/page (GSM) or 67 chars/page (UCS-2). The absolute maximum is 1530 characters (GSM) / 670 characters (UCS-2).

The maximum page count can also be configured per-message via content.options.pageLimit.

WhatsApp

Maximum message length is 4096 characters. The sender must be the phone number of a registered WhatsApp Business Account — contact eCall support to set it up. The Sticker content type is not supported for WhatsApp.

RCS

Maximum message length is 1000 characters. The RCS sender ID must be registered with the RCS provider — contact eCall support to obtain it.

Authorizations

BasicAuth

AuthorizationstringRequired

HTTP Basic Authentication. Encode username:password in Base64 and pass as: Authorization: Basic <base64_encoded_credentials>

Use your eCall account credentials or a dedicated API sub-user created in the eCall portal (Interfaces → Overview).

Body

application/json

Request body for sending a single message. Use either to (single recipient) or toList (multiple recipients) — not both.

channelstring · enumRequired

The messaging channel to use.

Value	Description
Sms	SMS (also automatically routes to Pager or Voice for landline numbers if configured)
Whatsapp	WhatsApp Business messaging
Rcs	Rich Communication Services

Example: SmsPossible values:

fromstringRequired

Sender address.

• SMS: Up to 16 numeric characters or up to 11 alphanumeric characters (ASCII 32–126). Test sender values carefully — not all providers accept all alphanumeric characters. Free accounts may only use the registered mobile number.
• WhatsApp: Phone number of the registered WhatsApp Business Account in international format (e.g. 0041769999999). Contact eCall support to set up.
• RCS: Your RCS sender ID as assigned by the provider. Contact eCall support to register and obtain the sender ID.

Example: 0041769999999

tostring · nullableOptional

Single recipient address in international format (e.g. 0041781234567 or [phone]). Mutually exclusive with toList.

Example: [phone]

sendDatestring · nullableOptional

Scheduled send time in ISO 8601 format. If omitted, the message is sent immediately.

Example: 2025-12-20T10:00:00Z

contentone ofRequired

Message content. For SMS, WhatsApp, and RCS, use TextContent.

or

or

or

or

or

or

or

or

or

or

or

Responses

200

Message accepted successfully.

application/json

400

The request is invalid. This may be caused by a missing required parameter, an invalid value, or a constraint violation. Check the errorCode and errorDetails in the response body for specifics.

application/json

401

The Authorization header is missing or the credentials are invalid. Verify your username, password, and Base64 encoding.

application/json

500

An unexpected error occurred on the eCall server. Retry after a short delay. If the problem persists, contact eCall support and include the x-f24-request-id header value from the response.

application/json

post/api/v2/message

HTTPcURLJavaScriptPython

POST /api/v2/message HTTP/1.1
Host: rest.ecall.ch
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "channel": "Sms",
  "from": "0041769999999",
  "to": "0041798888888",
  "content": {
    "type": "Text",
    "text": "Hello from eCall!"
  }
}

Basic SMSSMS with notification callbacksSMS to multiple recipientsFlash SMS with page limitBasic RCS message

{
  "messageId": "97031dc9-3814-4178-a31c-1599aa83ba67",
  "timestamp": "2022-10-17T18:36:14.517Z"
}

Get message status

get

Retrieves the current delivery status of a previously sent message. The messageId is obtained from the send response.

Status can be queried up to seven days after sending.

Voice channel note

Voice messages cannot be sent directly via the REST API. However, if the "Convert SMS to voice for landline numbers" option is enabled in the eCall portal (Account Settings → SMS), SMS sent to Swiss or German landline numbers are automatically converted to voice calls. A status query on such a message returns channel: Voice with voice-specific status codes.

Authorizations

BasicAuth

AuthorizationstringRequired

HTTP Basic Authentication. Encode username:password in Base64 and pass as: Authorization: Basic <base64_encoded_credentials>

Use your eCall account credentials or a dedicated API sub-user created in the eCall portal (Interfaces → Overview).

Path parameters

messageIdstring · uuidRequired

Unique message identifier as returned in the send response.

Example: 97031dc9-3814-4178-a31c-1599aa83ba67

Responses

200

Status retrieved successfully.

application/json

400

The request is invalid. This may be caused by a missing required parameter, an invalid value, or a constraint violation. Check the errorCode and errorDetails in the response body for specifics.

application/json

401

The Authorization header is missing or the credentials are invalid. Verify your username, password, and Base64 encoding.

application/json

404

The requested resource (message ID, media ID, etc.) was not found.

application/json

500

An unexpected error occurred on the eCall server. Retry after a short delay. If the problem persists, contact eCall support and include the x-f24-request-id header value from the response.

application/json

get/api/v2/message/{messageId}

HTTPcURLJavaScriptPython

GET /api/v2/message/{messageId} HTTP/1.1
Host: rest.ecall.ch
Authorization: Basic username:password
Accept: */*

{
  "channel": "Sms",
  "messageId": "97031dc9-3814-4178-a31c-1599aa83ba67",
  "status": "Delivered",
  "reasonCode": 0,
  "reason": "ESME_ROK",
  "timestamp": "2022-10-17T18:36:16.243Z",
  "from": "0041769999999",
  "to": "0041798888888",
  "pageTotal": 2
}