Skip to content
KDJ SMS
Developers

Add SMS to your applications

A JSON REST API, authenticated with a key specific to each application.

Quick start

  1. 1

    Create an application

    In your workspace, under Applications: an API key is generated for it.

  2. 2

    Pick a sender

    Use a Sender ID approved for your account.

  3. 3

    Send your first SMS

    A POST request with the key in the X-API-Key header.

Send an SMS

curl -X POST https://api.kdjcorporationgroup.com/api/v1/sms/send \
  -H "X-API-Key: $KDJ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"MASOCIETE","to":"2376XXXXXXXX","content":"Hello! Your order is ready.","externalId":"commande-1234"}'

Response

{
  "id": "3f6c2a1e-…",
  "externalId": "commande-1234",
  "from": "MASOCIETE",
  "to": "2376XXXXXXXX",
  "content": "Hello! Your order is ready.",
  "dlrStatus": null,
  "errorMessage": null,
  "createdAt": "2026-11-20T10:15:00Z"
}

Keep your key on the server side: never embed it in a mobile app or a web page.

Endpoints

  • POST/api/v1/sms/send

    Sends an SMS to one recipient.

  • POST/api/v1/sms/batch

    Sends several SMS in one request, with shared or personalised content.

  • GET/api/v1/sms/status/{id}

    Returns the delivery status of an SMS.

  • GET/api/v1/balance

    Returns your account's SMS balance.

Delivery statuses

  • dlrStatus = null

    Waiting for the operator's delivery report.

  • DELIVRD

    Delivered to the recipient's phone.

  • UNDELIV, REJECTD, EXPIRED…

    Not delivered: invalid number, phone unreachable for too long…

  • errorMessage ≠ null

    Refused before sending (balance, sender, number…).

Full documentation

Ready to send your first SMS?

Tell us about your project: the KDJ team will get back to you to open your workspace.