PindoDocs
Web AppWeb

API Reference

Every Messaging endpoint, with request bodies and responses. Code samples are available in nine languages: pick yours once and it sticks across the docs.

Send an SMS

POST/v1/sms/
# Send a single sms
curl -X POST \
https://api.pindo.io/v1/sms/ \
-H 'Accept: */*' \
-H 'Authorization: Bearer your-token' \
-H 'Content-Type: application/json' \
-d '{
"to" : "+250781234567",
"text" : "Hello from Pindo",
"sender" : "PindoTest"
}'

# Send bulk sms
curl -X POST \
https://api.pindo.io/v1/sms/bulk \
-H 'Accept: */*' \
-H 'Authorization: Bearer your-token' \
-H 'Content-Type: application/json' \
-d '{
"recipients" : [{"phonenumber": "+250781234567", "name": "Remy Muhire"}],
"text" : "Hello @contact.name, Welcome to Pindo",
"sender" : "PindoTest"
}'
{
  "bonus": 0.0,
  "discount": 0.4,
  "item_count": 1,
  "item_price": 0.006,
  "remaining_balance": 71421.953,
  "self_url": "http://api.pindo.io/v1/sms/out_sms_01H7DJEJ1YZKTNT8EDXY2C7YG9",
  "sms_id": "out_sms_01H7DJEJ1YZKTNT8EDXY2C7YG9",
  "status": "sent",
  "to": "+250789385878",
  "total_cost": 0.006
}

Send bulk SMS

POST/v1/sms/bulk
curl -X POST \
  https://api.pindo.io/v1/sms/bulk \
  -H 'Accept: */*' \
  -H 'Authorization: Bearer your-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "recipients" : [{"phonenumber": "+250781234567", "name": "Remy Muhire"}],
    "text" : "Hello @contact.name, Welcome to Pindo",
    "sender" : "PindoTest"
  }'

List inbound

GET/v1/sms/inbounds
{
  "inbound_sms": [
    {
      "account_id": 11783,
      "conversation_id": null,
      "created_at": "2022-08-05T12:32:42.196907",
      "id": 20,
      "inbound_sms_number": "+250781113333",
      "text": "Hello world !"
    }
  ],
  "pages": {
    "page": 1,
    "pages": 1,
    "per_page": 20,
    "total": 20
  }
}

Verify

POST/v1/sms/verify
POST/v1/sms/verify/check
curl -X POST \
  https://api.pindo.io/v1/sms/verify \
  -H 'Authorization: Bearer your-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "brand": "PindoTest",
    "number": "+250781234567"
  }'

Full walkthroughs live in the guides: Send an SMS, Bulk SMS, Inbound, and Verify.