Turn your Android phone into an SMS gateway with our simple API—no registration required! Experience instant setup, fast message delivery, and priority endpoints. Ideal for small projects, capstone and small to medium businesses. Plus, you can get started at using it at no cost.
By downloading the app, you consent to Terms & Conditions and Data Policy.
\nFor complete data transparency and ownership, we provide a dedicated database here. Every message sent via the API is securely stored in this database, ensuring that only you, as the client, have full access and control over your data.
\nNote: Select your preferred language for API examples in Documentation Settings - Language Dropdown (default: cURL).
\n![](\"https://email-analytics-beta.up.railway.app/logo.png\"){kind=logo}
","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"34829587","collectionId":"41cb084a-f104-49e7-8e91-aaf4161ed44a","publishedId":"2sAXjM4BkU","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-01T14:55:43.000Z"},"item":[{"name":"Send Single Message","id":"fd189ed1-36a7-4209-9619-78db4d406e32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app.
\n","type":"text"},{"key":"sim","value":"1","description":"(Required) Allowed values: 1 or 2 (Relies on the system’s default SMS SIM. Due to new Android permissions, manually select your preferred SIM for sending messages in Android settings and match it with the sim value if necessary.)
\n","type":"text"},{"key":"phone","value":"09175628943","description":"(Required) The recipient's mobile number can be entered in E.164 format or as a locally formatted number, based on the country code in your profile settings.
\nExample for the Philippines:
\n(Required) Your message with a maximum lenth of 160 characters.
\n","type":"text"}]},"url":"https://api.message-gateways.com/v1/sms/send/single","description":"This endpoint allows you to send a single SMS message using the specified SMS API key. It is a priority endpoint that processes requests immediately and returns a response as long as the application is ready to receive the message. The rate limit is 20 messages per minute.
\n","urlObject":{"protocol":"https","path":["v1","sms","send","single"],"host":["api","message-gateways","com"],"query":[],"variable":[]}},"response":[{"id":"60fb73e7-5656-43eb-9272-cffa4f293ade","name":"Send Single Message","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app.","type":"text"},{"key":"sim","value":"1","description":"(Required) Allowed values: 1 or 2 (SIM 1 or SIM 2)","type":"text"},{"key":"phone","value":"09175628943","description":"(Required) The recipient's mobile number can be entered in E.164 format or as a locally formatted number, based on the country code in your profile settings.\nExample for the Philippines: \n- E.164: +639175628943\n- Local: 09175628943","type":"text"},{"key":"message","value":"Your message here","description":"(Required) Your message with a maximum lenth of 160 characters.","type":"text"}]},"url":{"raw":"https://api.message-gateways.com/v1/sms/send/single","protocol":"https","host":["api","message-gateways","com"],"path":["v1","sms","send","single"],"query":[{"key":"","value":null,"type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"20"},{"key":"X-RateLimit-Remaining","value":"19"},{"key":"Date","value":"Sun, 26 Jan 2025 13:03:42 GMT"},{"key":"X-RateLimit-Reset","value":"1737896683"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"65"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=72"}],"cookie":[],"responseTime":null,"body":"{\n \"sms_id\": 1,\n \"status\": \"SENT\",\n \"message\": \"Message has been SENT\"\n}"}],"_postman_id":"fd189ed1-36a7-4209-9619-78db4d406e32"},{"name":"Get Single Message","id":"275aca07-dcb3-40f3-b186-3cf68f76fbc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.message-gateways.com/v1/sms/get/single","description":"This endpoint allows you to retrieve a specific SMS message using the provided SMS API key and the unique message ID. It provides detailed information about the message, including the message status, phone number, and creation timestamp. The rate limit for this endpoint is 60 requests per minute.
\n","urlObject":{"protocol":"https","path":["v1","sms","get","single"],"host":["api","message-gateways","com"],"query":[{"disabled":true,"description":{"content":"(Required) Your SMS API Key. You can view your api key when you download and use the app.
\n","type":"text/plain"},"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000"},{"disabled":true,"description":{"content":"(Required) The ID of the message to retrieve.
\n","type":"text/plain"},"key":"message_id","value":"1"}],"variable":[]}},"response":[{"id":"828f04b8-bdeb-4bf6-b7f2-e5d4698422af","name":"Get Single Message","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.message-gateways.com/v1/sms/get/single?sms_api_key=0000-0000-0000-0000-0000-0000-0000-0000&message_id=1","protocol":"https","host":["api","message-gateways","com"],"path":["v1","sms","get","single"],"query":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app."},{"key":"message_id","value":"1","description":"(Required) The ID of the message to retrieve."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining","value":"7"},{"key":"Date","value":"Sun, 26 Jan 2025 14:40:02 GMT"},{"key":"X-RateLimit-Reset","value":"1737902403"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"163"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=72"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": [\n {\n \"sms_id\": 1,\n \"sim\": \"1\",\n \"phone\": \"09175628943\",\n \"message\": \"Your message here\",\n \"status\": \"SENT\",\n \"message_created\": \"2025-01-26T05:03:43.000Z\"\n }\n ]\n}"}],"_postman_id":"275aca07-dcb3-40f3-b186-3cf68f76fbc5"},{"name":"Remove Single Message","id":"89537c36-a22e-4dc2-b092-65f76a192e33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.message-gateways.com/v1/sms/remove/single","description":"This endpoint allows you to delete a specific SMS message using your SMS API key and the unique message ID. Simply provide the API key and message ID to remove the message. The rate limit for this endpoint is 60 requests per minute.
\n","urlObject":{"protocol":"https","path":["v1","sms","remove","single"],"host":["api","message-gateways","com"],"query":[{"disabled":true,"description":{"content":"(Required) Your SMS API Key. You can view your api key when you download and use the app.
\n","type":"text/plain"},"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000"},{"disabled":true,"description":{"content":"(Required) The ID of the message to remove.
\n","type":"text/plain"},"key":"message_id","value":"1"}],"variable":[]}},"response":[{"id":"19e6959f-c6e2-4856-ae15-d148df42068e","name":"Remove Single Message","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"https://api.message-gateways.com/v1/sms/remove/single?sms_api_key=0000-0000-0000-0000-0000-0000-0000-0000&message_id=1","protocol":"https","host":["api","message-gateways","com"],"path":["v1","sms","remove","single"],"query":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app."},{"key":"message_id","value":"1","description":"(Required) The ID of the message to remove."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Date","value":"Sun, 26 Jan 2025 14:57:15 GMT"},{"key":"X-RateLimit-Reset","value":"1737903490"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"58"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=72"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Message removed successfully.\"\n}"}],"_postman_id":"89537c36-a22e-4dc2-b092-65f76a192e33"},{"name":"Get Multiple Messages","id":"46093c81-6344-4bca-88bf-6f6a099b255a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.message-gateways.com/v1/sms/get/multiple","description":"This endpoint enables you to fetch a batch of SMS messages by specifying criteria such as date range, status, and pagination. With the required SMS API key and optional parameters like page, limit, startDate, endDate, and status, you can tailor the response to your needs. The rate limit is 60 requests per minute.
\n","urlObject":{"protocol":"https","path":["v1","sms","get","multiple"],"host":["api","message-gateways","com"],"query":[{"disabled":true,"description":{"content":"(Required) Your SMS API Key. You can view your api key when you download and use the app.
\n","type":"text/plain"},"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000"},{"disabled":true,"description":{"content":"(Optional) Specifies which page of the results to return. The default is 1.
\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"(Optional) Specifies which page of the messages results to return. The default is 100.
\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"(Optional) Limits messages to the specified period defined by startDate and endDate. Format is \"YYYY-MM-DD\"
\n","type":"text/plain"},"key":"startDate","value":"2024-01-01"},{"disabled":true,"description":{"content":"(Optional) Limits messages to the specified period defined by startDate and endDate. Format is \"YYYY-MM-DD\"
\n","type":"text/plain"},"key":"endDate","value":"2030-12-31"},{"disabled":true,"description":{"content":"(Optional) Return only messages with the specified status. \nPossible values:
\n(Required) Your SMS API Key. You can view your api key when you download and use the app.
\n","type":"text"},{"key":"sim","value":"1","description":"(Required) Allowed values: 1 or 2 (Relies on the system’s default SMS SIM. Due to new Android permissions, manually select your preferred SIM for sending messages in Android settings and match it with the sim value if necessary.)
\n","type":"text"},{"key":"contacts","value":"+639561672921, +639561672929, +639561672930","description":"(Required) The recipient's mobile number can be entered in E.164 format or as a locally formatted number, based on the country code in your profile settings.
\nExample for the Philippines:
\n(Required) Your message with a maximum lenth of 160 characters.
\n","type":"text"}]},"url":"https://api.message-gateways.com/v1/sms/send/multiple","description":"This endpoint allows you to send multiple SMS messages using the specified SMS API key. The messages will be processed as part of the regular queue, but if a new priority message arrives, it will be sent immediately. By default, the response will mark the messages as \"QUEUED.\" The rate limit for this endpoint is 10 requests per minute, with a maximum of 100 recipients per request.
\n","urlObject":{"protocol":"https","path":["v1","sms","send","multiple"],"host":["api","message-gateways","com"],"query":[],"variable":[]}},"response":[{"id":"f714a8d2-6597-476a-a591-329d3c419484","name":"Send Multiple Messages","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app.","type":"text"},{"key":"sim","value":"1","description":"(Required) Allowed values: 1 or 2 (SIM 1 or SIM 2)","type":"text"},{"key":"contacts","value":"+639561672921, +639561672929, +639561672930","description":"(Required) The recipient's mobile number can be entered in E.164 format or as a locally formatted number, based on the country code in your profile settings.\n\nExample for the Philippines: \n- E.164: +639175628943\n- Local: 09175628943","type":"text"},{"key":"message","value":"Your message here","description":"(Required) Your message with a maximum lenth of 160 characters.","type":"text"}]},"url":"https://api.message-gateways.com/v1/sms/send/multiple"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"233"},{"key":"Date","value":"Sun, 26 Jan 2025 15:44:51 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=72"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"messages\": [\n {\n \"sms_id\": 1,\n \"status\": \"QUEUED\",\n \"message\": \"Message is on Queued.\"\n },\n {\n \"sms_id\": 2,\n \"status\": \"QUEUED\",\n \"message\": \"Message is on Queued.\"\n },\n {\n \"sms_id\": 3,\n \"status\": \"QUEUED\",\n \"message\": \"Message is on Queued.\"\n }\n ]\n}"}],"_postman_id":"97d5ceee-b35d-4049-b6de-c8ea91219e0b"},{"name":"Send Single OTP","event":[{"listen":"test","script":{"id":"60c1e014-6ccc-40ba-9284-d630c41d4ee2","exec":[""],"type":"text/javascript","packages":{}}}],"id":"17923828-dffa-40c2-b8c6-010a0222da26","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app.
\n","type":"text"},{"key":"sim","value":"1","description":"(Required) Allowed values: 1 or 2 (Relies on the system’s default SMS SIM. Due to new Android permissions, manually select your preferred SIM for sending messages in Android settings and match it with the sim value if necessary.)
\n","type":"text"},{"key":"phone","value":"09175628943","description":"(Required) The recipient's mobile number can be entered in E.164 format or as a locally formatted number, based on the country code in your profile settings.
\nExample for the Philippines:
\n(Required) Your OTP message, with a maximum length of 160 characters, must include {{otp}} as a placeholder for the generated code.
\n","type":"text"}]},"url":"https://api.message-gateways.com/v1/sms/send/single","description":"This endpoint allows you to send a single OTP message using the specified SMS API key. It is a priority endpoint that processes requests immediately and returns a response as long as the application is ready to send the message. The rate limit is 20 messages per minute.
\n","urlObject":{"protocol":"https","path":["v1","sms","send","single"],"host":["api","message-gateways","com"],"query":[],"variable":[]}},"response":[{"id":"c80779c4-ef1b-4902-8e18-dcf6f1b3c777","name":"Send Single OTP","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"sms_api_key","value":"0000-0000-0000-0000-0000-0000-0000-0000","description":"(Required) Your SMS API Key. You can view your api key when you download and use the app.","type":"text"},{"key":"sim","value":"1","description":"(Required) Allowed values: 1 or 2 (SIM 1 or SIM 2)","type":"text"},{"key":"phone","value":"09175628943","description":"(Required) The recipient's mobile number can be entered in E.164 format or as a locally formatted number, based on the country code in your profile settings.\n\nExample for the Philippines: \n- E.164: +639175628943\n- Local: 09175628943","type":"text"},{"key":"message","value":"Your OTP code is {{otp}}.","description":"(Required) Your OTP message, with a maximum length of 160 characters, must include {{otp}} as a placeholder for the generated code.","type":"text"}]},"url":"https://api.message-gateways.com/v1/sms/send/otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-RateLimit-Limit","value":"20"},{"key":"X-RateLimit-Remaining","value":"18"},{"key":"Date","value":"Sun, 26 Jan 2025 17:14:22 GMT"},{"key":"X-RateLimit-Reset","value":"1737911714"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"81"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=72"}],"cookie":[],"responseTime":null,"body":"{\n \"sms_id\": 3994,\n \"status\": \"SENT\",\n \"message\": \"Your OTP code is 519350.\",\n \"otp\": 519350\n}"}],"_postman_id":"17923828-dffa-40c2-b8c6-010a0222da26"}],"variable":[{"key":"sms_api_key","value":"org_id"},{"key":"sim","value":"1"},{"key":"phone_number","value":"09175628943"},{"key":"message","value":"09561672928"}]}