UBill API - provides programmatic access to our resources. You will be able to integrate our service into your system and communicate with clients easily.
\nAPI implementations in different languages, provided by different sources.
\n| statusID | Description |
|---|---|
0 | BrandName Created |
10 | The brandName field is empty |
20 | The minimum number of characters in the brandName must be 2 and the maximum number 11 |
30 | Unauthorized markings are used in the brandName |
40 | brandName has already been added |
50 | Wait for the last added brandName to be authenticated |
90 | Json Error |
99 | General error |
| statusID | Description |
|---|---|
0 | BrandName Deleted |
10 | BrandName not found |
90 | Json Error |
99 | General error |
OTP messages are intended strictly for authentication flows (login, verification, password reset).
\nMisuse of the otp parameter may result in delivery restrictions or account limitations.
The API does not enforce a strict limit on the number of recipient numbers.
\nActual limits are imposed by URL and HTTP header size constraints (Cloudflare, proxies, browsers).
\n✅ Up to ~1500 numbers per request works reliably.
\n⚠️ Around 2000+ numbers may result in Header overflow errors.
These errors occur before the request reaches the API, at the HTTP / proxy level.
\nUse GET only for small to medium requests.
\nFor large recipient lists, always use POST.
\nOTP messages are intended strictly for authentication flows (login, verification, password reset).
\nMisuse of the otp parameter may result in delivery restrictions or account limitations.
Max request body size: 100 MB → Requests exceeding this size will be rejected.
\nCloudflare proxied timeout: 100 seconds → Requests taking longer will return 524 Timeout.
\nFor large SMS batches, split requests into smaller chunks to avoid timeouts or memory issues.
\nUse stopList to avoid sending messages to blocked numbers.
\nPractical Observation from Testing:
\nIn our tests, SMS messages were successfully sent to up to 500,000 numbers in a single request. Sending requests above this number may lead to memory, timeout, or request size issues. Actual limits may vary depending on text length, encoding, and server load.
\nRecommendation:
\nFor safe and reliable operation, it is recommended to limit requests to around 100,000 numbers per batch.
\n","urlObject":{"protocol":"https","path":["v1","sms","send"],"host":["api","ubill","dev"],"query":[],"variable":[]}},"response":[{"id":"3a502982-b2bb-4cb5-b9a3-3516eaf38517","name":"Send SMS","originalRequest":{"method":"POST","header":[{"key":"key","value":"0123456789","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"brandID\": 1,\n \"numbers\": [\n 995511194242,\n 995511194242\n ],\n \"text\": \"Message\",\n \"stopList\": false, // Enable/disable checking numbers in the stop list\n \"sendTime\": \"2026-02-01 23:01\" // sendTime (optional)\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ubill.dev/v1/sms/send"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"statusID\": 0,\n \"smsID\": 111,\n \"message\": \"SMS Sended\"\n}"}],"_postman_id":"1488d24c-b167-47f5-a5cd-858857508032"},{"name":"Send SMS - Multiple Text","event":[{"listen":"test","script":{"id":"129b87de-4b47-4d83-8953-aadb5a747ab0","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"1d027a0e-d047-48fb-9671-b449dc0c389b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"key"},{"key":"value","value":"otp parameter may result in delivery restrictions or account limitations.Practical Observation from Testing:
\nActual limits may vary depending on text length, encoding, and server load.
\nRecommendation:
\nFor safe and reliable operation, it is recommended to limit requests to the numbers listed above per batch, according to the number of concatenated SMS messages being sent.
\n","urlObject":{"protocol":"https","path":["v1","sms","send"],"host":["api","ubill","dev"],"query":[],"variable":[]}},"response":[{"id":"086c9579-3b5c-439d-8349-739e7f8d6ebe","name":"Send SMS - Multiple Text","originalRequest":{"method":"POST","header":[{"key":"key","value":"0123456789","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"brandID\": 1,\n \"numbers\": [\n {\n \"number\": 995511194242,\n \"text\": \"გამარჯობა ნიკოლოზ\"\n },\n {\n \"number\": 995511194242,\n \"text\": \"გამარჯობა გიორგი\"\n }\n ],\n \"stopList\": false, // Enable/disable checking numbers in the stop list\n \"sendTime\": \"2026-02-01 23:01\" // sendTime (optional)\n}","options":{"raw":{"language":"json"}}},"url":"https://api.ubill.dev/v1/sms/send"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"statusID\": 0,\n \"smsID\": 111,\n \"message\": \"SMS Sended\"\n}"}],"_postman_id":"1d027a0e-d047-48fb-9671-b449dc0c389b"},{"name":"Send SMS XML","id":"bdd0d2f3-bb44-4f81-ab88-ef519261c2cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"\n| statusID | Description |
|---|---|
0 | SMS Sended |
10 | brandID not found |
20 | Numbers not found |
30 | Empty message text |
40 | Not enough SMS |
50 | Valid numbers not found |
90 | Json Error |
99 | General error |
Max request body size: 100 MB → Requests exceeding this size will be rejected.
\nCloudflare proxied timeout: 100 seconds → Requests taking longer will return 524 Timeout.
For large SMS batches, split requests to smaller chunks to avoid timeouts or memory issues.
\nUse stopList to avoid sending messages to blocked numbers.
Statuses
\n","urlObject":{"protocol":"https","path":["v1","sms","report","{smsID}"],"host":["api","ubill","dev"],"query":[],"variable":[]}},"response":[{"id":"114ab01e-3acf-49d3-84d8-620ffba8299b","name":"Delivery Report","originalRequest":{"method":"GET","header":[{"key":"key","value":"0123456789","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://api.ubill.dev/v1/sms/report/1111"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"statusID\": 0,\n \"result\": [\n {\n \"number\": \"995592194242\",\n \"statusID\": \"0\"\n },\n {\n \"number\": \"995592194242\",\n \"statusID\": \"0\"\n }\n ]\n}"}],"_postman_id":"5b34de68-fd38-485d-9834-1070c0914fd9"},{"name":"Get SMS Balance","id":"0bbcf4c0-f543-4d2e-a337-2d4eb2f777fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.ubill.dev/v1/sms/balance?key=0123456789","urlObject":{"protocol":"https","path":["v1","sms","balance"],"host":["api","ubill","dev"],"query":[{"key":"key","value":"0123456789"}],"variable":[]}},"response":[{"id":"e645fbe4-2d12-45ef-a9b7-123b36ab2bf6","name":"Get SMS Balance","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.ubill.dev/v1/sms/balance?key=0123456789","protocol":"https","host":["api","ubill","dev"],"path":["v1","sms","balance"],"query":[{"key":"key","value":"0123456789"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"statusID\": 0,\n \"sms\": 5000\n}"}],"_postman_id":"0bbcf4c0-f543-4d2e-a337-2d4eb2f777fa"},{"name":"Callback Report","id":"9a5f0886-4a85-4ec9-9618-2eede51b0c8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://example.com/callback?key=YourCallbackKey&smsID=12345678&number=995511194242&statusID=1&date=2026-02-01 12:02:02","description":"The SMS API allows you to automatically receive the status of sent messages on your server via the Callback mechanism.
\nWhen a message status changes (Sent, Received, Not Delivered, etc.), the system will send a GET request to your specified HTTPS URL.
\nCallback URL requirements:
\nMust start with https://
Method: GET
\nSet in company API settings
\n$key = $_GET['key'] ?? null;\n$smsID = $_GET['smsID'] ?? null;\n$number = $_GET['number'] ?? null;\n$statusID = $_GET['statusID'] ?? null;\n$date = $_GET['date'] ?? null;\n\n// Validation: ensure the key matches your callback key\nif ($key !== 'YourCallbackKey') {\n http_response_code(403);\n echo 'Forbidden';\n exit;\n}\n\n// Process the received status in your system\nhttp_response_code(200);\necho 'OK';\n?>\n\n