Introduction

The Multicountry SMS API lets you send messages to and receive messages from mobile devices across supported countries. Outbound (mobile-terminated) messages are sent from your application to the Beem Messaging Platform (MP) using HTTP. Inbound (mobile-originated) messages and delivery reports are sent from MP to your server using HTTP callbacks. Each message consists of parameters sent as form fields using HTTP POST or GET. POST is recommended — GET requests can be limited in size and may be truncated by browsers or intermediate proxies. The platform supports HTTP/1.0 and HTTP/1.1 with persistent connections.

HTTP API

Send text and binary SMS, request JSON or XML responses, and receive delivery reports and inbound messages over HTTPS.

SMPP

Connect directly to the Messaging Platform using the SMPP protocol for high-throughput message submission.

How it works

Your Application
      │
      │ HTTP POST/GET (outbound SMS)
      ▼
Beem Messaging Platform
      │
      ▼
Mobile Network
      │
      ▼
Recipient Device

Inbound MO / DLR
      │
      ▼
Beem Messaging Platform
      │
      │ HTTP POST to your callback URL
      ▼
Your Application

Base URLs

Purpose	URL
Send messages	`https://api.blsmsgw.com:8443`
Check balance	`https://www.blsmsgw.com/portal`

Billing

Messages are billed from your Multicountry SMS account balance according to destination country and message type. Check balance via the portal balance API documented in your account setup. Contact support@beem.africa for tariffs and top-ups.

What’s in this section

Prerequisites — account setup and credentials
Message encoding — GSM, UCS2, binary, URL encoding, and addresses
Sending messages — client-to-platform flow and response formats
API responses — HTTP and platform status codes
Throughput & connections — TPS and connection limits
Delivery reports — DLR callbacks via DLRADDRESS
Inbound two-way SMS — mobile-originated messages
Parameters reference — send, DLR, and MO parameter details
SMPP integration — connection parameters and bind settings
SMPP error codes — common SMPP status codes

Getting Started

APIs

HTTP API

SMPP

How it works

Base URLs

Billing

What’s in this section

HTTP API

SMPP

​How it works

​Base URLs

​Billing

​What’s in this section

How it works

Base URLs

Billing

What’s in this section