API Documentation

Full HTTP REST API reference for integrating SBS TELECOM messaging.

HTTP REST API Reference

The SBS TELECOM HTTP API provides a simple, powerful interface for sending SMS messages, querying delivery status, and managing your account programmatically.

Base URL

https://api.sbstelecom.co.uk/v1

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys are generated and managed in your client portal. We recommend using separate API keys for production and development environments.

Send a Message — POST /messages

Send a single SMS message.

POST /v1/messages
Content-Type: application/json

{
  "to": "+447911123456",
  "from": "SBSTEL",
  "text": "Your verification code is 847291"
}

Response:

{
  "id": "msg_01HXZ9K...",
  "status": "queued",
  "to": "+447911123456",
  "from": "SBSTEL",
  "created_at": "2025-01-01T12:00:00Z"
}

Message Status Codes

  • queued — Message accepted and queued for delivery
  • sent — Message submitted to carrier
  • delivered — Delivery confirmed by carrier
  • failed — Delivery failed — see error code
  • expired — Message expired before delivery

Rate Limits

Default API rate limits are 100 requests/second. Higher limits are available for enterprise accounts. Contact support to increase your rate limit.