Getting started

Prerequisites, request format, endpoint details, and a quick browser test.

Core features

• Send SMS, fax, and voice messages.

• Query message status with JobID or a time range.

• Receive callbacks and forward inbound SMS.

Prerequisites

• You need an eCall business account.

• A standard account is enough for a 30-day test.

• The HTTP interface must be enabled on your account.

• Your software must be able to call a URL.

Request format

Messages can be submitted with GET or POST.

The interface uses these rules:

• Parameters use key=value pairs.

• Parameters are separated by &.

• IDs are case-insensitive.

• Send all characters as UTF-8.

• URL-encode reserved characters when needed.

For POST, keep & separators when the content type is application/x-www-form-urlencoded.

Example:

https://url.ecall.ch/api/sms?username=johnsmith&password=s3cr3t&address=0041791234567&message=This%20is%20a%20test

Account settings are cached for performance. Changes can take some time to apply.

Endpoint

Use this base URL for send jobs:

https://url.ecall.ch/

Testing the interface

You can test the interface directly in a browser.

1

Open your browser

2

Enter a test URL

Replace username, password, and address with your values.

https://url.ecall.ch/api/sms?username=johnsmith&password=s3cr3t&address=0041791234567&message=This%20is%20a%20test

https://url.ecall.ch/Api/Sms?Address=%2B41791112233&Message=Test&Username=foo&Password=bar

3

Check the response

The service returns HTTP status codes and eCall result codes.

Reference document

• Specification version: 2.22

• Source document date: 2025-03-17

• Owner: F24 Schweiz AG, Wollerau, Switzerland

• Classification: public