> For the complete documentation index, see [llms.txt](https://panaceamobile.gitbook.io/panacea-mobile-help-centre/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://panaceamobile.gitbook.io/panacea-mobile-help-centre/developers/https-api/single-sends.md).

# Single Sends

We'll mainly discuss the primary integration method for Panacea Mobile SMS Gateway (PM-SMS) called the "Message Send" endpoint.\
\
It's the go-to option for sending individual messages.

### message\_send()

This method is for sending a single transactional message.\
\
Examples of this could be sending a verification code to a user via SMS or another similar type of notification.

<mark style="color:green;">`GET`</mark> [`/https://eu-api.panaceamobile.com/json?`](#message_send)

{% hint style="warning" %}
Please reach out to your Account Manager or Support to confirm your API URL as this may vary depending on your specific account configuration.&#x20;
{% endhint %}

**Parameters**

<table><thead><tr><th width="277">HTTPS GET Parameters</th><th width="167">Type</th><th>Description</th></tr></thead><tbody><tr><td><strong><code>action</code></strong></td><td>message_send</td><td>Set to message_send for this endpoint</td></tr><tr><td><strong><code>username</code></strong></td><td>userx</td><td>Your account username</td></tr><tr><td><strong><code>password</code></strong></td><td>passwordy</td><td>Your account password</td></tr><tr><td><strong><code>to</code></strong></td><td>27821230000</td><td>Destination phone number</td></tr><tr><td><strong><code>from</code></strong></td><td>12345</td><td>Sender ID – this can be any value and can be used as an internal reference</td></tr><tr><td><strong><code>text</code></strong></td><td>This is your SMS text</td><td>URL Encoded message text content</td></tr><tr><td><code>client_reference</code></td><td>REF12300089</td><td>Customer provided reference (Optional)</td></tr><tr><td><code>charset</code></td><td></td><td>Defaults to GSM-7 bit (Advanced)</td></tr><tr><td><code>auto_detect_encoding</code></td><td></td><td>Default to “yes”, this ensures that is special characters are used the system will encode the message correctly. This may incur extra costs.</td></tr><tr><td><code>report_mask</code></td><td></td><td>Defaults to 19, only used with report_url</td></tr><tr><td><code>report_url</code></td><td></td><td><p>If provided, PM-SMS system will ping back to</p><p>this URL with message delivery status.</p></td></tr><tr><td><code>verbose</code></td><td>1</td><td>Set to <code>1</code> to get additional details in the API response.<br><br><em>*Please contact your Account Manager or Support to verify if this feature is available for your account configuration.</em></td></tr></tbody></table>

{% hint style="warning" %}
**BOLD PARAMETERS ARE MANDATORY**
{% endhint %}

#### Example API Call:

```
https://eu-api.panaceamobile.com/json?action=message_send&username=userx&password=passwordy&to=27820123456&from=12345&text=URL+encoded+text+string&client_reference=REF12345
```

#### Example Output:

{% tabs %}
{% tab title="200" %}

```html
{
"status":1,"message":"Sent",
"details":"8beda1a8-5c12-489f-0107-
123000000003"
}
```

{% endtab %}
{% endtabs %}

***

For developers looking for practical implementation guidance, please visit our **Examples** page. Here, you'll find a comprehensive collection of code samples tailored to help you integrate and use our HTTPS API effectively.

{% content-ref url="/pages/ne2mxI3hQBIJ2JIGt8V0" %}
[Examples](/panacea-mobile-help-centre/developers/https-api/examples.md)
{% endcontent-ref %}