Queries
Balance, SenderID, message status, and reporting endpoints.
Balance
/balance/ returns the current main SMS balance of the account.
POSThttps://api.turkeysms.com.tr/balance/
200 OKResponse
{
"result": true,
"result_code": "TS-1040",
"result_message": "Balance inquiry successful.",
"balance_main": 1500
}SenderID list
/senderid/check returns the list of approved SenderIDs on your account, with id, title, and status.
POSThttps://api.turkeysms.com.tr/senderid/check
Message status
/sms/status queries the delivery state of a message by sms_id: queued, sent, delivered, failed, or expired.
POSThttps://api.turkeysms.com.tr/sms/status
cURL
curl -X POST https://api.turkeysms.com.tr/sms/status \
-H "Content-Type: application/json" \
-d '{"api_key": "YOUR_API_KEY", "sms_id": 1000007721}'Reports
/reports/basic returns total, delivered, and failed counts for a campaign. /reports/detailed returns recipient-level statuses with pagination (max 500 rows per page).
POSThttps://api.turkeysms.com.tr/reports/basic
POSThttps://api.turkeysms.com.tr/reports/detailed
Instead of continuously polling for delivery results, using Webhooks is more efficient.