{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "{{ config(\"app.url\") }}" } ], "info": { "name": "SMS Gateway API Documentation", "_postman_id": "5cfc5476-d242-428a-a6b5-80d1bf58fa00", "description": "", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "Call Log", "description": "Call Log", "item": [ { "name": "List all calls", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/calls", "query": [ { "key": "type", "value": "Incoming", "description": "Filter by call type.", "disabled": false }, { "key": "sim", "value": "1", "description": "Filter by SIM ID. Must be at least 1.", "disabled": false }, { "key": "answered", "value": "", "description": "", "disabled": true } ], "raw": "{{baseUrl}}\/api\/v1\/calls?type=Incoming&sim=1&answered=" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of calls. The calls are returned sorted by creation date, with the most recently created call appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":149,\"number\":\"973-450-3511\",\"type\":\"Missed\",\"sim_id\":67,\"started_at\":\"1991-01-07T14:12:01.000000Z\",\"duration\":1912},{\"id\":150,\"number\":\"1-513-623-4192\",\"type\":\"Missed\",\"sim_id\":68,\"started_at\":\"1980-06-11T18:33:36.000000Z\",\"duration\":3149}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Delete a call", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/calls\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/calls\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the call." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a call." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "Campaigns", "description": "Campaigns", "item": [ { "name": "List all campaigns", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns", "query": [ { "key": "status", "value": "Sent", "description": "Filter by campaign status.", "disabled": false }, { "key": "type", "value": "MMS", "description": "Filter by campaign type.", "disabled": false }, { "key": "recurring", "value": "1", "description": "Filter by recurring campaigns.", "disabled": false }, { "key": "after", "value": "2026-06-16T00:00:00+05:30", "description": "Filter by campaigns at or after this ISO-8601 datetime. Must be a valid date in the format Y-m-d\\TH:i:sP. Must be a date before or equal to before.", "disabled": false }, { "key": "before", "value": "2026-06-16T00:00:00+05:30", "description": "Filter by campaigns at or before this ISO-8601 datetime. Must be a valid date in the format Y-m-d\\TH:i:sP. Must be a date after or equal to after.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/campaigns?status=Sent&type=MMS&recurring=1&after=2026-06-16T00%3A00%3A00%2B05%3A30&before=2026-06-16T00%3A00%3A00%2B05%3A30" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of campaigns. The campaigns are returned sorted by creation date, with the most recently created campaign appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":51,\"name\":\"Cullen Roberts\",\"scheduled_at\":null,\"timezone\":\"UTC\",\"recurring\":false,\"frequency\":null,\"frequency_unit\":null,\"ends_at\":null,\"repeat_at\":null,\"active_hours\":\"00:00-23:59\",\"days_of_week\":[1,2,3,4,5,6,7],\"status\":\"Processed\",\"type\":\"SMS\",\"options\":{\"delay\":\"0\",\"prioritize\":false,\"delivery_report\":false},\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"},{\"id\":52,\"name\":\"Catalina Mills\",\"scheduled_at\":null,\"timezone\":\"UTC\",\"recurring\":false,\"frequency\":null,\"frequency_unit\":null,\"ends_at\":null,\"repeat_at\":null,\"active_hours\":\"00:00-23:59\",\"days_of_week\":[1,2,3,4,5,6,7],\"status\":\"Processed\",\"type\":\"SMS\",\"options\":{\"delay\":\"0\",\"prioritize\":false,\"delivery_report\":false},\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a campaign", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the campaign." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a Campaign object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":53,\"name\":\"Gideon Boyer\",\"scheduled_at\":null,\"timezone\":\"UTC\",\"recurring\":false,\"frequency\":null,\"frequency_unit\":null,\"ends_at\":null,\"repeat_at\":null,\"active_hours\":\"00:00-23:59\",\"days_of_week\":[1,2,3,4,5,6,7],\"status\":\"Processed\",\"type\":\"SMS\",\"options\":{\"delay\":\"0\",\"prioritize\":false,\"delivery_report\":false},\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"}", "name": "" } ] }, { "name": "List all devices used in a campaign", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:campaign_id\/devices", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:campaign_id\/devices", "variable": [ { "id": "campaign_id", "key": "campaign_id", "value": 1, "description": "The ID of the campaign." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of devices used in a campaign. The devices are returned with sims used in the campaign and status of the campaign on the device." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":65,\"name\":null,\"model\":\"Nokia X20\",\"android_version\":\"7\",\"app_version\":\"0.20.34\",\"battery\":46,\"is_charging\":false,\"enabled\":true,\"sims\":[{\"id\":69,\"name\":\"Koelpin, Nolan and Bailey\",\"label\":null,\"number\":\"+15202822732\",\"country\":\"SZ\",\"carrier\":\"Miller Ltd\",\"slot\":0,\"data_roaming\":false,\"signal_strength\":4,\"active\":true}]},{\"id\":66,\"name\":null,\"model\":\"Xiaomi Mi 11\",\"android_version\":\"9\",\"app_version\":\"3.73.98\",\"battery\":71,\"is_charging\":false,\"enabled\":true,\"sims\":[{\"id\":70,\"name\":\"Hermiston, Parker and Marvin\",\"label\":null,\"number\":\"+13648507362\",\"country\":\"GE\",\"carrier\":\"Littel Ltd\",\"slot\":0,\"data_roaming\":false,\"signal_strength\":4,\"active\":true}]}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":10,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "List all sending servers used in a campaign", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:campaign_id\/sending-servers", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:campaign_id\/sending-servers", "variable": [ { "id": "campaign_id", "key": "campaign_id", "value": 1, "description": "The ID of the campaign." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of sending servers used in a campaign. The sending servers are returned with sender ids used in the campaign and status of the campaign on the sending server." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":43,\"name\":\"Gideon Boyer\",\"enabled\":true,\"sender_ids\":[{\"id\":45,\"value\":\"511682\"}]},{\"id\":44,\"name\":\"Camylle Zieme\",\"enabled\":true,\"sender_ids\":[{\"id\":46,\"value\":\"795647\"}]}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":10,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Update a campaign", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the campaign." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"New Campaign\"}" }, "description": "Updates the specific campaign by setting the values of the parameters passed." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Delete a campaign", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/campaigns\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/campaigns\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the campaign." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a campaign. Also deletes all messages or USSD pulls associated with it. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "Contact Lists", "description": "Contact Lists", "item": [ { "name": "List all contact lists", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of contact lists. The contact lists are returned sorted by creation date, with the most recently created contact list appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":63,\"name\":\"deborah.mayert\"},{\"id\":64,\"name\":\"tyrique.damore\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":10,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a Contact List object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":65,\"name\":\"deborah.mayert\"}", "name": "" } ] }, { "name": "Create a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"My List\"}" }, "description": "" }, "response": [ { "header": [], "code": 201, "body": "{\"id\":66,\"name\":\"brown.maggie\"}", "name": "Created" } ] }, { "name": "Update a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"My List\"}" }, "description": "Updates the specific contact list by setting the values of the parameters passed." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Delete a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes the specific contact list. Also deletes all contacts and fields associated with it. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Duplicate a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:contact_list_id\/duplicate", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:contact_list_id\/duplicate", "variable": [ { "id": "contact_list_id", "key": "contact_list_id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"My List\"}" }, "description": "Duplicates the specified contact list along with its fields. Contacts are not duplicated." }, "response": [ { "header": [], "code": 201, "body": "{\"id\":67,\"name\":\"brown.maggie\"}", "name": "Created" } ] }, { "name": "List all fields for a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:contact_list_id\/fields", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:contact_list_id\/fields", "variable": [ { "id": "contact_list_id", "key": "contact_list_id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of fields for a contact list. The fields are returned sorted by creation date, with the most recently created field appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":49,\"label\":\"Exercitationem\",\"tag\":\"exercitationem\",\"type\":\"text\",\"options\":null,\"default_value\":null,\"required\":false},{\"id\":50,\"label\":\"Enim\",\"tag\":\"enim\",\"type\":\"text\",\"options\":null,\"default_value\":null,\"required\":false}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":50,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a field", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/fields\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/fields\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the field." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a Field object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":51,\"label\":\"Itaque\",\"tag\":\"itaque\",\"type\":\"text\",\"options\":null,\"default_value\":null,\"required\":false}", "name": "" } ] }, { "name": "Create a field for a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:contact_list_id\/fields", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:contact_list_id\/fields", "variable": [ { "id": "contact_list_id", "key": "contact_list_id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"label\":\"First Name\",\"tag\":\"first_name\",\"type\":\"text\",\"default_value\":\"John\",\"required\":true,\"options\":[{\"label\":\"Option 1\",\"value\":\"option_1\"}]}" }, "description": "" }, "response": [ { "header": [], "code": 201, "body": "{\"id\":52,\"label\":\"Veritatis\",\"tag\":\"veritatis\",\"type\":\"text\",\"options\":null,\"default_value\":null,\"required\":false}", "name": "Created" } ] }, { "name": "Update a field", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/fields\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/fields\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the field." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"label\":\"First Name\",\"tag\":\"first_name\",\"type\":\"text\",\"default_value\":\"John\",\"required\":true,\"options\":[{\"label\":\"Option 1\",\"value\":\"option_1\"}]}" }, "description": "Updates the specific field by setting the values of the parameters passed. It is recommended to retrieve the field first to get the field's current state because partial updates are not supported." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Delete a field", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/fields\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/fields\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the field." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a field. Also deletes all associated field values of contacts. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "Contacts", "description": "Contacts", "item": [ { "name": "List all contacts for a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:contact_list_id\/contacts", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:contact_list_id\/contacts", "variable": [ { "id": "contact_list_id", "key": "contact_list_id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of contacts for a contact list. The contacts are returned sorted by creation date, with the most recently created contact appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":2017,\"mobile_number\":\"+19475350806\",\"eveniet\":\"qui\",\"subscribed\":true,\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"},{\"id\":2018,\"mobile_number\":\"+14586288218\",\"et\":\"qui\",\"subscribed\":true,\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a contact", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contacts\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contacts\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the contact." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a Contact object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":2019,\"mobile_number\":\"+13807084142\",\"quam\":\"rerum\",\"subscribed\":true,\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"}", "name": "" } ] }, { "name": "Create a contact in a contact list", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contact-lists\/:contact_list_id\/contacts", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contact-lists\/:contact_list_id\/contacts", "variable": [ { "id": "contact_list_id", "key": "contact_list_id", "value": 1, "description": "The ID of the contact list." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"mobile_number\":\"+12025886500\",\"subscribed\":true,\"first_name\":\"John\",\"last_name\":\"Doe\"}" }, "description": "" }, "response": [ { "header": [], "code": 201, "body": "{\"id\":2020,\"mobile_number\":\"+19852822732\",\"subscribed\":true,\"created_at\":\"2026-10-03T13:19:53.000000Z\",\"updated_at\":\"2026-10-03T13:19:53.000000Z\"}", "name": "Created" } ] }, { "name": "Update a contact", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contacts\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contacts\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the contact." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"mobile_number\":\"+12025886500\",\"subscribed\":true,\"first_name\":\"John\",\"last_name\":\"Doe\"}" }, "description": "Update a contact in a contact list with the given data. It is recommended to retrieve the contact first to get the contact's current state because partial updates are not supported." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Delete a contact", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/contacts\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/contacts\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the contact." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a contact. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "Devices", "description": "Devices", "item": [ { "name": "List all devices", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/devices", "query": [], "raw": "{{baseUrl}}\/api\/v1\/devices" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of devices. The devices are returned sorted by creation date, with the most recently created device appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":67,\"name\":null,\"model\":\"Nokia X20\",\"enabled\":true,\"android_version\":\"7\",\"app_version\":\"0.20.34\",\"battery\":46,\"is_charging\":false,\"updated_at\":\"2026-10-03T13:19:53.000000Z\",\"sims\":[{\"id\":71,\"name\":\"Carter, Zieme and Oberbrunner\",\"label\":null,\"number\":\"+16819707512\",\"country\":\"KM\",\"carrier\":\"Kassulke-Ankunding\",\"slot\":0,\"data_roaming\":true,\"signal_strength\":3,\"active\":true}]},{\"id\":68,\"name\":null,\"model\":\"Oppo Reno 6 Pro 5G\",\"enabled\":true,\"android_version\":\"13\",\"app_version\":\"0.8.34\",\"battery\":81,\"is_charging\":false,\"updated_at\":\"2026-10-03T13:19:53.000000Z\",\"sims\":[{\"id\":72,\"name\":\"Dooley, Little and West\",\"label\":null,\"number\":\"+13107965540\",\"country\":\"AW\",\"carrier\":\"Kohler-Mitchell\",\"slot\":0,\"data_roaming\":false,\"signal_strength\":3,\"active\":true}]}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a device", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/devices\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/devices\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the device." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a Device object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":69,\"name\":null,\"model\":\"Nokia X20\",\"enabled\":true,\"android_version\":\"7\",\"app_version\":\"0.20.34\",\"battery\":46,\"is_charging\":false,\"updated_at\":\"2026-10-03T13:19:54.000000Z\",\"sims\":[{\"id\":73,\"name\":\"Miller Ltd\",\"label\":null,\"number\":\"+13604961855\",\"country\":\"AI\",\"carrier\":\"Hessel and Sons\",\"slot\":0,\"data_roaming\":true,\"signal_strength\":2,\"active\":true}]}", "name": "" } ] }, { "name": "Update a device", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/devices\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/devices\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the device." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"My Device\"}" }, "description": "Update the specific device by setting the values of the parameters passed." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Delete a device", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/devices\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/devices\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the device." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a device. Also removes the SIMs associated with the device and any messages, USSD Pulls and call logs associated with those SIMs. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "Messages", "description": "Messages", "item": [ { "name": "Send messages", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/messages\/send", "query": [], "raw": "{{baseUrl}}\/api\/v1\/messages\/send" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"sims\":[1],\"sender_ids\":[1],\"random_sender\":true,\"contact_lists\":[1],\"mobile_numbers\":[\"+12345678901\"],\"type\":\"SMS\",\"message\":\"Hello, World!\",\"attachments\":[\"https:\\\/\\\/example.com\\\/image.jpg\"],\"delivery_report\":true,\"delay\":60,\"prioritize\":true,\"name\":\"My Campaign\",\"scheduled_at\":\"2021-01-01T12:00:00Z\",\"recurring\":true,\"frequency\":1,\"frequency_unit\":\"day\",\"ends_at\":\"2021-01-01T12:00:00Z\",\"timezone\":\"UTC\",\"days_of_week\":[1],\"active_hours\":{\"start\":\"08:00\",\"end\":\"17:00\"}}" }, "description": "Send an SMS or MMS campaign." }, "response": [ { "header": [], "code": 201, "body": "{\"id\":54,\"name\":\"Merl Champlin\",\"scheduled_at\":null,\"timezone\":\"UTC\",\"recurring\":false,\"frequency\":null,\"frequency_unit\":null,\"ends_at\":null,\"repeat_at\":null,\"active_hours\":\"00:00-23:59\",\"days_of_week\":[1,2,3,4,5,6,7],\"status\":\"Processed\",\"type\":\"SMS\",\"options\":{\"delay\":\"0\",\"prioritize\":false,\"delivery_report\":false},\"created_at\":\"2026-10-03T13:19:54.000000Z\",\"updated_at\":\"2026-10-03T13:19:54.000000Z\"}", "name": "Created" } ] }, { "name": "List all messages", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/messages", "query": [ { "key": "user", "value": "1", "description": "Filter by user id. Only available for admin. Must be at least 1.", "disabled": false }, { "key": "campaign", "value": "1", "description": "Filter by campaign id. Must be at least 1.", "disabled": false }, { "key": "sim", "value": "1", "description": "Filter by sim id. This field is prohibited if sender_id is present. Must be at least 1.", "disabled": false }, { "key": "message", "value": "Hello, World!", "description": "Filter by message. Must not be greater than 1600 characters.", "disabled": false }, { "key": "type", "value": "SMS", "description": "Filter by message type.", "disabled": false }, { "key": "statuses[0]", "value": "Sent", "description": "", "disabled": false }, { "key": "after", "value": "2026-06-16T00:00:00+05:30", "description": "Filter by messages that are sent at or after this ISO-8601 datetime. Must be a valid date in the format Y-m-d\\TH:i:sP. Must be a date before or equal to before.", "disabled": false }, { "key": "before", "value": "2026-06-16T00:00:00+05:30", "description": "Filter by messages that are sent at or before this ISO-8601 datetime. Must be a valid date in the format Y-m-d\\TH:i:sP. Must be a date after or equal to after.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/messages?user=1&campaign=1&sim=1&message=Hello%2C%20World%21&type=SMS&statuses%5B0%5D=Sent&after=2026-06-16T00%3A00%3A00%2B05%3A30&before=2026-06-16T00%3A00%3A00%2B05%3A30" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of messages. The messages are returned sorted by sent date, with the most recently sent message appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":2073,\"from\":\"+19734503511\",\"to\":\"+13529767860\",\"phone_id\":null,\"content\":\"Exercitationem itaque non aspernatur. Nam incidunt nemo distinctio quam sed quasi commodi.\",\"type\":\"SMS\",\"attachments\":[],\"status\":\"Sent\",\"response\":[],\"messenger\":\"Sim #74\",\"scheduled_at\":null,\"sent_at\":\"2026-10-03T01:46:47.000000Z\",\"delivered_at\":null},{\"id\":2074,\"from\":\"+18328270032\",\"to\":\"+12817418959\",\"phone_id\":null,\"content\":\"Ducimus est ut voluptatum porro repudiandae doloremque qui. Est id sed voluptatem saepe. Dicta tempore blanditiis quos et iste placeat. Ut voluptas similique magnam quis qui.\",\"type\":\"SMS\",\"attachments\":[],\"status\":\"Sent\",\"response\":[],\"messenger\":\"Sim #75\",\"scheduled_at\":null,\"sent_at\":\"2026-10-02T21:29:46.000000Z\",\"delivered_at\":null}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a message", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/messages\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/messages\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the message." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a Message object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":2075,\"from\":\"+19475350806\",\"to\":\"+13807084142\",\"phone_id\":null,\"content\":\"Qui eveniet et quasi qui. Quae sequi qui est rerum quam recusandae omnis. Quidem perferendis et et amet earum illum.\",\"type\":\"SMS\",\"attachments\":[],\"status\":\"Sent\",\"response\":[],\"messenger\":\"Sim #76\",\"scheduled_at\":null,\"sent_at\":\"2026-10-03T01:48:28.000000Z\",\"delivered_at\":null}", "name": "" } ] }, { "name": "Delete a message", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/messages\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/messages\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the message." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a message. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "SenderIds", "description": "SenderIds", "item": [ { "name": "List all sender ids", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sender-ids", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sender-ids" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of sender ids. The sender ids are returned sorted by creation date, with the most recently created sender id appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":47,\"value\":\"647973\"},{\"id\":48,\"value\":\"646904\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a sender id", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sender-ids\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sender-ids\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the sender id." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a SenderId object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":49,\"value\":\"574311\"}", "name": "" } ] }, { "name": "Create a sender id for a sending server", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sending-servers\/:sending_server_id\/sender-ids", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sending-servers\/:sending_server_id\/sender-ids", "variable": [ { "id": "sending_server_id", "key": "sending_server_id", "value": 1, "description": "The ID of the sending server." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"value\":\"MySenderID\"}" }, "description": "" }, "response": [ { "header": [], "code": 201, "body": "{\"id\":50,\"value\":\"583848\"}", "name": "Created" } ] }, { "name": "Delete a sender id", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sender-ids\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sender-ids\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the sender id." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a sender id. Also removes any messages sent using this sender id. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "Sending Servers", "description": "Sending Servers", "item": [ { "name": "List all sending servers", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sending-servers", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sending-servers" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of sending servers. The sending servers are returned sorted by creation date, with the most recently created sending server appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":45,\"name\":\"Gideon Boyer\",\"driver\":\"Custom\",\"supported_types\":[\"SMS\",\"MMS\",\"WhatsApp\"],\"config\":{\"url\":\"https:\\\/\\\/smsgateway.rbsoft.org\",\"method\":\"GET\",\"params\":[{\"key\":\"sims[]\",\"value\":\"{sender_id}\"},{\"key\":\"mobile_numbers[]\",\"value\":\"{mobile_number}\"},{\"key\":\"message\",\"value\":\"{message}\"},{\"key\":\"attachments\",\"value\":\"{attachments[]}\"},{\"key\":\"type\",\"value\":\"MMS\"}],\"headers\":[{\"key\":\"Authorization\",\"value\":\"Bearer NzczMjdhNzk0NTc4NTk3MTQxNTY2OTU1NDY1OTc5NTE=\"}]},\"enabled\":true,\"created_at\":\"2026-10-03T13:19:54.000000Z\"},{\"id\":46,\"name\":\"Verna Miller MD\",\"driver\":\"Custom\",\"supported_types\":[\"SMS\",\"MMS\",\"WhatsApp\"],\"config\":{\"url\":\"https:\\\/\\\/smsgateway.rbsoft.org\",\"method\":\"GET\",\"params\":[{\"key\":\"sims[]\",\"value\":\"{sender_id}\"},{\"key\":\"mobile_numbers[]\",\"value\":\"{mobile_number}\"},{\"key\":\"message\",\"value\":\"{message}\"},{\"key\":\"attachments\",\"value\":\"{attachments[]}\"},{\"key\":\"type\",\"value\":\"MMS\"}],\"headers\":[{\"key\":\"Authorization\",\"value\":\"Bearer NzczMjdhNzk0NTc4NTk3MTQxNTY2OTU1NDY1OTc5NTE=\"}]},\"enabled\":true,\"created_at\":\"2026-10-03T13:19:54.000000Z\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a sending server", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sending-servers\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sending-servers\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the sending server." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a SendingServer object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":47,\"name\":\"Gideon Boyer\",\"driver\":\"Custom\",\"supported_types\":[\"SMS\",\"MMS\",\"WhatsApp\"],\"config\":{\"url\":\"https:\\\/\\\/smsgateway.rbsoft.org\",\"method\":\"GET\",\"params\":[{\"key\":\"sims[]\",\"value\":\"{sender_id}\"},{\"key\":\"mobile_numbers[]\",\"value\":\"{mobile_number}\"},{\"key\":\"message\",\"value\":\"{message}\"},{\"key\":\"attachments\",\"value\":\"{attachments[]}\"},{\"key\":\"type\",\"value\":\"MMS\"}],\"headers\":[{\"key\":\"Authorization\",\"value\":\"Bearer NzczMjdhNzk0NTc4NTk3MTQxNTY2OTU1NDY1OTc5NTE=\"}]},\"enabled\":true,\"created_at\":\"2026-10-03T13:19:54.000000Z\"}", "name": "" } ] }, { "name": "Create a sending server", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sending-servers", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sending-servers" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Twilio\",\"driver\":\"twilio\",\"supported_types\":[\"MMS\"],\"config\":{\"account_sid\":\"ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"auth_token\":\"your_auth_token\",\"from\":\"+15017122661\"},\"enabled\":true}" }, "description": "" }, "response": [ { "header": [], "code": 201, "body": "{\"id\":48,\"name\":\"Gideon Boyer\",\"driver\":\"Custom\",\"supported_types\":[\"SMS\",\"MMS\",\"WhatsApp\"],\"config\":{\"url\":\"https:\\\/\\\/smsgateway.rbsoft.org\",\"method\":\"GET\",\"params\":[{\"key\":\"sims[]\",\"value\":\"{sender_id}\"},{\"key\":\"mobile_numbers[]\",\"value\":\"{mobile_number}\"},{\"key\":\"message\",\"value\":\"{message}\"},{\"key\":\"attachments\",\"value\":\"{attachments[]}\"},{\"key\":\"type\",\"value\":\"MMS\"}],\"headers\":[{\"key\":\"Authorization\",\"value\":\"Bearer NzczMjdhNzk0NTc4NTk3MTQxNTY2OTU1NDY1OTc5NTE=\"}]},\"enabled\":true,\"created_at\":\"2026-10-03T13:19:54.000000Z\"}", "name": "Created" } ] }, { "name": "Update a sending server", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sending-servers\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sending-servers\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the sending server." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Twilio\",\"driver\":\"twilio\",\"supported_types\":[\"WhatsApp\"],\"config\":{\"account_sid\":\"ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"auth_token\":\"your_auth_token\",\"from\":\"+15017122661\"},\"enabled\":true}" }, "description": "Update the specific sending server by setting the values of the parameters passed. It is recommended to retrieve the sending server first to get the sending server's current state because partial updates are not supported." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] }, { "name": "Delete a sending server", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/sending-servers\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/sending-servers\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the sending server." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a sending server. Also removes sender ids associated with the sending server and any messages associated with those sender ids. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] }, { "name": "USSD Pulls", "description": "USSD Pulls", "item": [ { "name": "Send USSD pulls", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ussd-pulls\/send", "query": [], "raw": "{{baseUrl}}\/api\/v1\/ussd-pulls\/send" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"sims\":[1],\"ussd_codes\":[\"*123#\"],\"delay\":60,\"prioritize\":true,\"name\":\"My Campaign\",\"scheduled_at\":\"2021-01-01T12:00:00Z\",\"recurring\":true,\"frequency\":1,\"frequency_unit\":\"day\",\"ends_at\":\"2021-01-01T12:00:00Z\",\"timezone\":\"UTC\",\"days_of_week\":[1],\"active_hours\":{\"start\":\"08:00\",\"end\":\"17:00\"},\"random_sender\":true}" }, "description": "Sends USSD Pull campaign." }, "response": [ { "header": [], "code": 201, "body": "{\"id\":58,\"name\":\"Merl Champlin\",\"scheduled_at\":null,\"timezone\":\"UTC\",\"recurring\":false,\"frequency\":null,\"frequency_unit\":null,\"ends_at\":null,\"repeat_at\":null,\"active_hours\":\"00:00-23:59\",\"days_of_week\":[1,2,3,4,5,6,7],\"status\":\"Processed\",\"type\":\"SMS\",\"options\":{\"delay\":\"0\",\"prioritize\":false,\"delivery_report\":false},\"created_at\":\"2026-10-03T13:19:54.000000Z\",\"updated_at\":\"2026-10-03T13:19:54.000000Z\"}", "name": "Created" } ] }, { "name": "List all USSD pulls", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ussd-pulls", "query": [ { "key": "user", "value": "1", "description": "Filter by user id. Only available for admin. Must be at least 1.", "disabled": false }, { "key": "campaign", "value": "1", "description": "Filter by campaign id. Must be at least 1.", "disabled": false }, { "key": "sim", "value": "1", "description": "Filter by sim id. Must be at least 1.", "disabled": false }, { "key": "statuses[0]", "value": "Failed", "description": "", "disabled": false }, { "key": "after", "value": "2026-06-16T00:00:00+05:30", "description": "Show USSD pulls that are sent at or after this ISO-8601 datetime. Must be a valid date in the format Y-m-d\\TH:i:sP. Must be a date before or equal to before.", "disabled": false }, { "key": "before", "value": "2026-06-16T00:00:00+05:30", "description": "Show USSD pulls that are sent at or before this ISO-8601 datetime. Must be a valid date in the format Y-m-d\\TH:i:sP. Must be a date after or equal to after.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/ussd-pulls?user=1&campaign=1&sim=1&statuses%5B0%5D=Failed&after=2026-06-16T00%3A00%3A00%2B05%3A30&before=2026-06-16T00%3A00%3A00%2B05%3A30" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns a list of USSD pulls. The USSD pulls are returned sorted by sent date, with the most recently sent USSD pull appearing first." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":293,\"code\":\"*3250#\",\"response\":\"Dolorem fuga recusandae ratione optio ut nobis. Rem esse reiciendis exercitationem itaque. Aspernatur odio nam incidunt nemo distinctio quam.\",\"status\":\"Completed\",\"sim_id\":77,\"sent_at\":\"2026-10-03T18:49:54.000000Z\",\"received_at\":\"2026-10-03T13:19:54.000000Z\"},{\"id\":294,\"code\":\"*6427236#\",\"response\":\"Et sapiente sit voluptate placeat quasi. Laboriosam cumque enim rem officiis non vel deserunt laboriosam. Omnis impedit expedita necessitatibus necessitatibus voluptatem.\",\"status\":\"Completed\",\"sim_id\":78,\"sent_at\":\"2026-10-03T18:49:54.000000Z\",\"received_at\":\"2026-10-03T13:19:54.000000Z\"}],\"links\":{\"first\":\"\\\/?page=1\",\"last\":\"\\\/?page=1\",\"prev\":null,\"next\":null},\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"links\":[{\"url\":null,\"label\":\"« Previous\",\"page\":null,\"active\":false},{\"url\":\"\\\/?page=1\",\"label\":\"1\",\"page\":1,\"active\":true},{\"url\":null,\"label\":\"Next »\",\"page\":null,\"active\":false}],\"path\":\"\\\/\",\"per_page\":100,\"to\":2,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve a USSD pull", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ussd-pulls\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/ussd-pulls\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the ussd pull." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves a USSD Pull object." }, "response": [ { "header": [], "code": 200, "body": "{\"id\":295,\"code\":\"*697#22#\",\"response\":\"Tempore in qui hic sequi in. Et enim qui eveniet et quasi qui corporis quae. Qui est rerum quam recusandae omnis dolore quidem perferendis. Et amet earum illum qui et maxime.\",\"status\":\"Completed\",\"sim_id\":79,\"sent_at\":\"2026-10-03T18:49:54.000000Z\",\"received_at\":\"2026-10-03T13:19:54.000000Z\"}", "name": "" } ] }, { "name": "Delete a USSD pull", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ussd-pulls\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/ussd-pulls\/:id", "variable": [ { "id": "id", "key": "id", "value": 1, "description": "The ID of the ussd pull." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Permanently deletes a USSD pull. It cannot be undone." }, "response": [ { "header": [], "code": 204, "body": null, "name": "No content" } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "Authorization", "type": "string" } ] } }