{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"19684fc0-f4ac-42d9-bd4c-b93a48bd9662","name":"v2 SMS API","description":"# MiMSMS Bulk SMS API — V2\n\nWelcome to the **MiMSMS V2 API** — a production-ready, developer-friendly platform for sending, scheduling, and managing SMS messages at scale. Whether you're delivering OTPs, running marketing campaigns, or tracking delivery reports, MiMSMS V2 API gives you full programmatic control over your messaging infrastructure.\n\n**Base URL:** `https://api.mimsms.com`\n\n---\n\n## What You Can Do\n\n| Feature | Description |\n| --- | --- |\n| **Send SMS** | Send transactional or promotional messages via GET or POST |\n| **Schedule SMS** | Queue messages for future delivery with ISO 8601 timestamps |\n| **Bulk Broadcast** | Send one message to thousands of recipients at once |\n| **Dynamic SMS** | Personalise each message per recipient in a single API call |\n| **Balance Check** | Monitor your remaining SMS credit in real time |\n| **Delivery Reports** | Track message delivery status using tracking IDs |\n| **Incoming SMS** | Pull inbound messages from your MiMSMS number |\n\n---\n\n## Authentication\n\nEvery request must include your account credentials. Pass them as **query parameters** (GET) or in the **request body** (POST).\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `userName` | `string` | Your registered MiMSMS account email address |\n| `apiKey` | `string` | Your unique API key — find it in the MiMSMS dashboard |\n\n> ⚠️ **Keep your** **`apiKey`** **secret.** Never expose it in client-side code or public repositories. \n  \n\n---\n\n## 📨 Message Types\n\nMiMSMS supports two message categories. Choose the right type for your use case:\n\n| Code | Type | Best For | DND Restriction |\n| --- | --- | --- | --- |\n| `T` | **Transactional** | OTPs, alerts, account notifications | ❌ Not restricted |\n| `P` | **Promotional** | Marketing, offers, campaigns | ✅ DND applies |\n\n---\n\n## 🌐 Endpoints at a Glance\n\n| Method | Endpoint | Purpose |\n| --- | --- | --- |\n| `POST` | `/api/V2/SMS` | Send transactional or promotional SMS |\n| `GET` | `/api/V2/Send` | Send SMS via query string |\n| `POST` | `/api/V2/Schedule` | Schedule SMS for future delivery |\n| `POST` | `/api/V2/OneToMany` | Broadcast one message to many recipients |\n| `GET` | `/api/V2/OneToMany` | Broadcast via query string |\n| `POST` | `/api/V2/DSMS` | Send dynamic personalised SMS |\n| `GET` | `/api/IncomingApi/PullSMS` | Fetch incoming messages |\n| `POST` | `/api/V2/DlrApi` | Get delivery report by tracking ID |\n| `POST` | `/api/V2/BalanceCheck` | Check SMS credit balance (POST) |\n| `GET` | `/api/V2/BalanceCheck` | Check SMS credit balance (GET) |\n\n---\n\n## 📋 Response Codes\n\nAll API responses return a numeric status code. Use the table below to interpret results:\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `200` | ✅ Success | SMS sent successfully |\n| `205` | ❌ Failed | Invalid message content |\n| `206` | ❌ Failed | Invalid mobile number |\n| `208` | ❌ Failed | Invalid Sender ID |\n| `209` | ❌ Failed | Message length exceeds maximum limit |\n| `213` | ❌ Failed | Parameter mismatch |\n| `216` | ❌ Failed | Insufficient balance |\n| `217` | ❌ Failed | Sender ID not found |\n| `218` | ❌ Failed | Sender ID not active |\n| `219` | ❌ Failed | Account not active |\n| `220` | ❌ Failed | Account expired |\n| `221` | ❌ Failed | SMS sending failed |\n| `401` | 🔒 Unauthorized | IP is blacklisted |\n| `401` | 🔒 Unauthorized | Invalid username or API key |\n| `500` | 💥 Server Error | Internal server error |\n\n---\n\n## Quick Start\n\n**1\\. Get your credentials** from the [MiMSMS SMS Panel](https://sms.mimsms.com)\n\n**2\\. Send your first SMS** using the `SendSMS (T)` POST request:\n\n``` json\nPOST https://api.mimsms.com/api/V2/SMS\nContent-Type: application/json\n{\n  \"apiKey\": \"YOUR_API_KEY\",\n  \"userName\": \"your@email.com\",\n  \"senderName\": \"YourSenderID\",\n  \"transactionType\": \"T\",\n  \"mobileNumber\": \"8801XXXXXXXXX\",\n  \"message\": \"Hello from MiMSMS!\"\n}\n\n ```\n\n**3\\. Check the response code** — `200` means your message was sent successfully.\n\n---\n\n## Support\n\nNeed help? Contact the MiMSMS Live Chat Team at [www.mimsms.com](https://www.mimsms.com) or mail to `support@mimsms.com`\n\n---","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"14759893","team":1618148,"collectionId":"19684fc0-f4ac-42d9-bd4c-b93a48bd9662","publishedId":"2sBXwpQCDh","public":true,"publicUrl":"https://v2.smsapi.bd","privateUrl":"https://go.postman.co/documentation/14759893-19684fc0-f4ac-42d9-bd4c-b93a48bd9662","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Access MiMSMS Bulk SMS API documentation to integrate fast, secure, and scalable SMS gateway services in Bangladesh. Send transactional and promotional SMS via simple REST API. Includes authentication, delivery reports, and real-time messaging support for developers and SaaS platforms."},{"name":"title","value":"MiMSMS Bulk SMS API Documentation | Fast and Reliable SMS Gateway for Bangladesh"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.2","publishDate":"2026-06-05T10:28:13.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"MiMSMS Bulk SMS API Documentation | Fast and Reliable SMS Gateway for Bangladesh","description":"Access MiMSMS Bulk SMS API documentation to integrate fast, secure, and scalable SMS gateway services in Bangladesh. Send transactional and promotional SMS via simple REST API. Includes authentication, delivery reports, and real-time messaging support for developers and SaaS platforms."},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"MiMSMS Production","id":"3ccf8980-f3d6-4804-813c-86ee6b183ba3","owner":"14759893","values":[],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/5a19907e0ce4b7d8c39ff3f61ac0e0aa333da80e7b0872abc40c5c8dcc610fa4","favicon":"https://v2.smsapi.bd/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"MiMSMS Production","value":"14759893-3ccf8980-f3d6-4804-813c-86ee6b183ba3"}],"canonicalUrl":"https://v2.smsapi.bd/view/metadata/2sBXwpQCDh"}