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.