{"info":{"_postman_id":"6ec27465-34f2-4bb4-b0fd-39d05d8e98c9","name":"SmsBower Protocol API","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"16514200","collectionId":"6ec27465-34f2-4bb4-b0fd-39d05d8e98c9","publishedId":"2sAYdkFTuc","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-04T10:23:54.000Z"},"item":[{"name":"Ejointech skyline modem","item":[{"name":"Webhook","id":"ea236e83-4120-4822-ad4a-55b2cce5df31","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"type\": \"dev-status\",\r\n \"mac\": \"00:1A:2B:3C:4D:5E\",\r\n \"status\": [\r\n {\r\n \"sn\": \"+79001234567\",\r\n \"iccid\": \"8970100000000000001\",\r\n \"imsi\": \"250010000000001\",\r\n \"st\": 1,\r\n \"active\": true\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/{{apiKey}}/webhook","urlObject":{"path":["api","{{apiKey}}","webhook"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"2be38f3a-9d18-403d-99e7-5a0d1d368c0e","name":"Success on update sim","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"type\": \"dev-status\",\r\n \"mac\": \"00:1A:2B:3C:4D:5E\",\r\n \"status\": [\r\n {\r\n \"sn\": \"+79001234567\",\r\n \"iccid\": \"8970100000000000001\",\r\n \"imsi\": \"250010000000001\",\r\n \"st\": 1,\r\n \"active\": true\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/webhook/{{apiKey}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Ok\"\n}"},{"id":"e22ec9a2-d852-425f-91f5-96ce6c793a94","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"type\": \"dev-status\",\r\n \"mac\": \"00:1A:2B:3C:4D:5E\",\r\n \"status\": [\r\n {\r\n \"sn\": \"+79001234567\",\r\n \"iccid\": \"8970100000000000001\",\r\n \"imsi\": \"250010000000001\",\r\n \"st\": 1,\r\n \"active\": true\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/webhook/{{apiKey}}"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Bad Api Key\"\n}"},{"id":"f2568dc2-8461-455a-9364-118a3aaf5444","name":"Error while handle sms","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"type\": \"recv-sms\",\r\n \"sms\": [\r\n [\r\n \"0\",\r\n \"1\",\r\n \"2026-02-05 10:00:00\",\r\n \"SenderID\",\r\n \"79990000000\",\r\n \"SGVsbG8gV29ybGQ=\"\r\n ]\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/webhook/{{apiKey}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"OK. Sms: Hello World. Some error. Call support with error id 123\"\n}"},{"id":"b7a18640-b674-465b-b9fd-4f94a5cf65b7","name":"Success on receive sms","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"type\": \"recv-sms\",\r\n \"sms\": [\r\n [\r\n null, \r\n null, \r\n \"2023-10-27 10:00:00\", \r\n \"BankInfo\", \r\n \"79001234567\", \r\n \"SGVsbG8gV29ybGQ=\"\r\n ]\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/webhook/{{apiKey}}"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"ea236e83-4120-4822-ad4a-55b2cce5df31"}],"id":"0dab4daa-4d89-49c2-b609-9c45c7aa02ee","description":"

Summary: Processes incoming webhooks from GSM gateways for device status updates and SMS reception.

\n

Key Functions:

\n\n","_postman_id":"0dab4daa-4d89-49c2-b609-9c45c7aa02ee"},{"name":"PUSH_SMS","id":"591703c2-7076-41c8-97e1-940764c3fb2f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"key","value":"{{api_key}}","type":"text","uuid":"7f467272-9d5d-4cc7-9712-f3d64bf2d393"},{"key":"action","value":"PUSH_SMS","type":"text","uuid":"d3aaf2f0-3016-47f1-b92d-76b668d45b6b"},{"key":"smsId","value":"12345","type":"text","uuid":"e74993aa-1757-4ca5-8a9a-2461de65f595"},{"key":"phone","value":"447472190082","type":"text","uuid":"20d34a6e-8e7f-49e4-ad4d-cb2782511ba4"},{"key":"phoneFrom","value":"Microsoft","type":"text","uuid":"fcb8973a-26a8-403d-9b54-a5a18200f7cf"},{"key":"text","value":"Microsoft access code: 5015","type":"text","uuid":"949780d5-95cb-4e1f-9823-49eb8ab59c73"},{"key":"call","value":"0","type":"text","uuid":"863ebc64-f01f-4462-afec-4dcfe02da3d9"},{"key":"voice","value":"0","type":"text","uuid":"245076f0-b74d-4cd5-81c0-b48cf9c89e54"}]},"url":"{{base_url}}/agent/api/sms","description":"

This POST request is sent from the partner's server to the SMSBOWER server at the address: https://smsbower.online/agent/api/sms

\n

If you receive a response with the status SUCCESS, mark the SMS as successfully delivered in your database and do not send it again. If a status other than SUCCESS is returned, repeat the request with a 10- second delay until you receive a SUCCESS status.

\n","urlObject":{"path":["agent","api","sms"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"0dfa229d-0078-4e33-a754-98d02e590a07","name":"Success sms","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"key","value":"{{api_key}}","type":"text","uuid":"7f467272-9d5d-4cc7-9712-f3d64bf2d393"},{"key":"action","value":"PUSH_SMS","type":"text","uuid":"d3aaf2f0-3016-47f1-b92d-76b668d45b6b"},{"key":"smsId","value":"12345","type":"text","uuid":"e74993aa-1757-4ca5-8a9a-2461de65f595"},{"key":"phone","value":"447472190082","type":"text","uuid":"20d34a6e-8e7f-49e4-ad4d-cb2782511ba4"},{"key":"phoneFrom","value":"Microsoft","type":"text","uuid":"fcb8973a-26a8-403d-9b54-a5a18200f7cf"},{"key":"text","value":"Microsoft access code: 5015","type":"text","uuid":"949780d5-95cb-4e1f-9823-49eb8ab59c73"},{"key":"call","value":"0","type":"text","uuid":"592e6aa3-2d50-48ac-a933-d1a08eeba0e5"},{"key":"voice","value":"0","type":"text","uuid":"1246f0dc-78d0-417b-8f7a-0c7b5bf93594"}]},"url":"{{base_url}}/agent/api/sms"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\"\n}"},{"id":"26725448-56ad-4009-873a-4e84b37c52a7","name":"Success flashcall","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"key","value":"{{api_key}}","type":"text","uuid":"7f467272-9d5d-4cc7-9712-f3d64bf2d393"},{"key":"action","value":"PUSH_SMS","type":"text","uuid":"d3aaf2f0-3016-47f1-b92d-76b668d45b6b"},{"key":"smsId","value":"12345","type":"text","uuid":"e74993aa-1757-4ca5-8a9a-2461de65f595"},{"key":"phone","value":"447472190082","type":"text","uuid":"20d34a6e-8e7f-49e4-ad4d-cb2782511ba4"},{"key":"phoneFrom","value":"446756540011","type":"text","uuid":"fcb8973a-26a8-403d-9b54-a5a18200f7cf"},{"key":"text","value":"446756540011","type":"text","uuid":"949780d5-95cb-4e1f-9823-49eb8ab59c73"},{"key":"call","value":"1","type":"text","uuid":"3feede37-ab2b-4408-ad7a-4b517e080469"},{"key":"voice","value":"0","type":"text","uuid":"74eef3f2-fab2-4ef7-8bb9-ac43f434f616"}]},"url":"{{base_url}}/agent/api/sms"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\"\n}"},{"id":"48b268ad-0634-4384-a7f4-259272c4eb45","name":"Success voice","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"key","value":"{{api_key}}","type":"text","uuid":"7f467272-9d5d-4cc7-9712-f3d64bf2d393"},{"key":"action","value":"PUSH_SMS","type":"text","uuid":"d3aaf2f0-3016-47f1-b92d-76b668d45b6b"},{"key":"smsId","value":"12345","type":"text","uuid":"e74993aa-1757-4ca5-8a9a-2461de65f595"},{"key":"phone","value":"447472190082","type":"text","uuid":"20d34a6e-8e7f-49e4-ad4d-cb2782511ba4"},{"key":"phoneFrom","value":"446756540011","type":"text","uuid":"fcb8973a-26a8-403d-9b54-a5a18200f7cf"},{"key":"text","value":"12345","type":"text","uuid":"949780d5-95cb-4e1f-9823-49eb8ab59c73"},{"key":"call","value":"0","type":"text","uuid":"3feede37-ab2b-4408-ad7a-4b517e080469"},{"key":"voice","value":"1","type":"text","uuid":"502b045e-e7a9-43c0-9de5-cb69e6d8ce66"}]},"url":"{{base_url}}/agent/api/sms"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\"\n}"}],"_postman_id":"591703c2-7076-41c8-97e1-940764c3fb2f"},{"name":"GET_SERVICES","id":"d45a55f7-2550-4d20-8a3d-035504e702e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"action\": \"GET_SERVICES\",\r\n \"key\": \"apikey\"\r\n}","options":{"raw":{"language":"json"}}},"url":"example.com","description":"

This request provides us with information about the quantity of phone number for services available for sale.

\n

The POST request is transmitted from the SMSBOWER server to the partner's server.

\n

! Please note: If your GSM modem is limited in the number of concurrently active modules, you should provide a count equal to the number of active modules.

\n","urlObject":{"host":["example","com"],"query":[],"variable":[]}},"response":[{"id":"18857c2d-4c27-40aa-a3f4-42f138b27a36","name":"Success","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"action\": \"GET_SERVICES\",\r\n \"key\": \"qwerty123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"example.com"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"countryList\":\n [\n {\n \"country\": \"russia\",\n \"operatorMap\":\n {\n \"beeline\":\n {\n \"ok\": 15,\n \"wa\": 20\n },\n \"megafon\":\n {\n \"vk\": 3,\n \"ok\": 10\n }\n }\n },\n {\n \"country\": \"ukraine\",\n \"operatorMap\":\n {\n \"life\":\n {\n \"vk\": 0,\n \"wa\": 32\n }\n }\n }\n ],\n \"status\": \"SUCCESS\"\n}"}],"_postman_id":"d45a55f7-2550-4d20-8a3d-035504e702e4"},{"name":"GET_NUMBER","id":"0b4f3902-efde-43b9-bd37-d41c26661655","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"action\": \"GET_NUMBER\",\r\n \"key\": \"qwerty123\",\r\n \"country\": \"russia\",\r\n \"operator\": \"beeline\",\r\n \"service\": \"tg\",\r\n \"sum\": \"20.00\"\r\n}","options":{"raw":{"language":"json"}}},"url":"example.com","description":"

This request provides us with a phone number that we pass on to the client.

\n

The POST request is transmitted from the SMSBOWER server to the partner's server.

\n

If the exceptionPhoneSet array contains a list of prefixes, for example 44742 and 44740, you should not provide a number that starts with any of these prefixes. The number of digits is not limited by the size of the prefix.

\n","urlObject":{"host":["example","com"],"query":[],"variable":[]}},"response":[{"id":"6ed5f372-04c4-4d40-9c5a-006322389c72","name":"Success","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"action\": \"GET_NUMBER\",\r\n \"key\": \"qwerty123\",\r\n \"country\": \"russia\",\r\n \"operator\": \"beeline\",\r\n \"service\": \"tg\",\r\n \"sum\": \"20.00\"\r\n}","options":{"raw":{"language":"json"}}},"url":"example.com"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"number\": \"79156537788\",\n \"activationId\": \"36532\",\n \"status\": \"SUCCESS\",\n \"call\": 1,\n \"voice\": 0\n}"}],"_postman_id":"0b4f3902-efde-43b9-bd37-d41c26661655"},{"name":"FINISH_ACTIVATION","id":"60b8b387-7fd0-4988-8beb-d6b89a8f0b18","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"action\": \"FINISH_ACTIVATION\",\r\n \"key\": \"qwerty123\",\r\n \"activationId\": 100,\r\n \"status\": 3\r\n}","options":{"raw":{"language":"json"}}},"url":"example.com","description":"

This request is transmitted from the SMSBOWER server to the partner's server to complete activation.

\n

POST request initiated from the SMSBOWER to the partner's server.

\n

Activation management is fully controlled by SMSBOWER. Due to factors beyond our control, we may not receive a response from you regarding a successful status change. Therefore, if SMSBOWER sends a repeat activation completion request, you should check for the existence of the activation ID on your end. If the activation exists, send a status of SUCCESS in response.

\n","urlObject":{"host":["example","com"],"query":[],"variable":[]}},"response":[{"id":"15964cb6-5cb7-4a01-aa96-58dadbed5831","name":"Success","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"action\": \"FINISH_ACTIVATION\",\r\n \"key\": \"qwerty123\",\r\n \"activationId\": 100,\r\n \"status\": 3\r\n}","options":{"raw":{"language":"json"}}},"url":"example.com"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"SUCCESS\"\n}"}],"_postman_id":"60b8b387-7fd0-4988-8beb-d6b89a8f0b18"},{"name":"Get statistic","id":"dc79a645-1be5-45b2-ab59-0dd90b0c651a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api/statistic/simCards?api_key={{api_key}}&countriesIds[]=31","description":"

📊 Agent SIM Statistics
Retrieves real-time statistics for SIM cards associated with the current agent.

\n

Features:
* Fetches only current active SIM status (not historical logs).
* Supports filtering by country.
* Provides a breakdown of SIM counts per service (Google, Telegram, etc.)

\n","urlObject":{"path":["api","statistic","simCards"],"host":["{{base_url}}"],"query":[{"key":"api_key","value":"{{api_key}}"},{"description":{"content":"

not required

\n","type":"text/plain"},"key":"countriesIds[]","value":"31"}],"variable":[]}},"response":[{"id":"5e98a833-cd6c-48f6-b687-32093a0c98e8","name":"Get statistic","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/statistic/simCards?api_key={{api_key}}&countriesIds[]=31","host":["{{base_url}}"],"path":["api","statistic","simCards"],"query":[{"key":"api_key","value":"{{api_key}}"},{"key":"countriesIds[]","value":"31","description":"not required"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": [\n {\n \"id\": 101,\n \"phone\": \"79001234567\",\n \"operator\": \"MTS\",\n \"status\": \"active\",\n \"last_activity\": \"2026-02-05 12:00:00\"\n }\n ],\n \"countByServices\": {\n \"google\": 10,\n \"whatsapp\": 5,\n \"telegram\": 8\n },\n \"total\": 1\n}"}],"_postman_id":"dc79a645-1be5-45b2-ab59-0dd90b0c651a"},{"name":"Get status","id":"1d2bd0fe-53b6-4c9a-882a-31018eaa3b08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/agent/api/getStatus?activationId={{activationId}}&api_key={{api_key}}","description":"

🔍 Get Activation Status
Returns the current processing state of a specific SMS activation.

\n","urlObject":{"path":["agent","api","getStatus"],"host":["{{base_url}}"],"query":[{"key":"activationId","value":"{{activationId}}"},{"key":"api_key","value":"{{api_key}}"}],"variable":[]}},"response":[{"id":"07d1d9e8-684d-460f-8025-79f44f438057","name":"Wait status","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/agent/api/getStatus?activationId={{activationId}}&api_key={{api_key}}","host":["{{base_url}}"],"path":["agent","api","getStatus"],"query":[{"key":"activationId","value":"{{activationId}}"},{"key":"api_key","value":"{{api_key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 0\n}"},{"id":"abecc1f6-7035-4d10-a6e9-a219340b8f8e","name":"Success activation","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/agent/api/getStatus?activationId={{activationId}}&api_key={{api_key}}","host":["{{base_url}}"],"path":["agent","api","getStatus"],"query":[{"key":"activationId","value":"{{activationId}}"},{"key":"api_key","value":"{{api_key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 6\n}"},{"id":"ca678558-c375-460f-8995-a439762fae07","name":"Canceled status","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/agent/api/getStatus?activationId={{activationId}}&api_key={{api_key}}","host":["{{base_url}}"],"path":["agent","api","getStatus"],"query":[{"key":"activationId","value":"{{activationId}}"},{"key":"api_key","value":"{{api_key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 8\n}"}],"_postman_id":"1d2bd0fe-53b6-4c9a-882a-31018eaa3b08"}]}