> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruach.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Send SMS (GET)

> Send SMS messages using GET method with URL parameters

## Send SMS (GET)

Send SMS messages using the GET method with URL parameters. This method is useful for simple integrations and testing.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.notify.ng/api/v2/SendSMS?ApiKey=YOUR_API_KEY&ClientId=YOUR_CLIENT_ID&SenderId=YOUR_SENDER_ID&Message=Hello%20World&MobileNumber=1234567890&Is_Unicode=false&Is_Flash=false"
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    ApiKey: 'YOUR_API_KEY',
    ClientId: 'YOUR_CLIENT_ID',
    SenderId: 'YOUR_SENDER_ID',
    Message: 'Hello World',
    MobileNumber: '1234567890',
    Is_Unicode: 'true',
    Is_Flash: 'false'
  });

  const response = await fetch(`https://app.notify.ng/api/v2/SendSMS?${params}`, {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests
  from urllib.parse import urlencode

  url = "https://app.notify.ng/api/v2/SendSMS"
  params = {
      "ApiKey": "YOUR_API_KEY",
      "ClientId": "YOUR_CLIENT_ID",
      "SenderId": "YOUR_SENDER_ID",
      "Message": "Hello World",
      "MobileNumber": "1234567890",
      "Is_Unicode": "true",
      "Is_Flash": "false"
  }

  response = requests.get(url, params=params)
  data = response.json()
  print(data)
  ```
</CodeGroup>

## Parameters

<ParamField query="ApiKey" type="string" required>
  Your API key for authentication
</ParamField>

<ParamField query="ClientId" type="string" required>
  Your client identifier for authentication
</ParamField>

<ParamField query="SenderId" type="string" required>
  Approved sender ID for the message
</ParamField>

<ParamField query="Message" type="string" required>
  Text message content to send (URL encoded)
</ParamField>

<ParamField query="MobileNumber" type="string" required>
  Mobile number or comma-separated numbers (e.g., "1234567890,0987654321")
</ParamField>

<ParamField query="Is_Unicode" type="boolean">
  Set to `true` for Unicode messages (default: `false`)
</ParamField>

<ParamField query="Is_Flash" type="boolean">
  Set to `true` for flash messages (default: `false`)
</ParamField>

<ParamField query="scheduleTime" type="string">
  Schedule time in `yyyy-MM-dd HH:MM` format (optional)
</ParamField>

<ParamField query="groupId" type="string">
  Group ID for sending to a group (optional)
</ParamField>

## Response

<ResponseField name="ErrorCode" type="number">
  Error code (0 for success)
</ResponseField>

<ResponseField name="ErrorDescription" type="string">
  Description of the result
</ResponseField>

<ResponseField name="Data" type="array">
  Array of message results
</ResponseField>

<ResponseField name="Data[].MobileNumber" type="string">
  Mobile number that received the message
</ResponseField>

<ResponseField name="Data[].MessageId" type="string">
  Unique message ID for tracking
</ResponseField>

### Success Response

```json theme={null}
{
  "ErrorCode": 0,
  "ErrorDescription": "Success",
  "Data": [
    {
      "MobileNumber": "7894561230",
      "MessageId": "3bb944ad-d943-419f-83dc-f979002a8c0b"
    }
  ]
}
```

### Error Response

```json theme={null}
{
  "ErrorCode": 003,
  "ErrorDescription": "SenderId cannot be blank"
}
```

## URL Encoding

When using GET method, ensure proper URL encoding:

### JavaScript Example

```javascript theme={null}
const message = "Hello World!";
const encodedMessage = encodeURIComponent(message);
// Result: "Hello%20World%21"
```

### Python Example

```python theme={null}
import urllib.parse

message = "Hello World!"
encoded_message = urllib.parse.quote(message)
# Result: "Hello%20World%21"
```

## Multiple Recipients

Send to multiple numbers using comma separation:

```
MobileNumber=1234567890,0987654321,5555555555
```

## Message Types

### Standard SMS

```
Is_Unicode=false&Is_Flash=false
```

### Unicode SMS (for special characters)

```
Is_Unicode=true&Is_Flash=false
```

### Flash SMS (appears on screen without saving)

```
Is_Unicode=false&Is_Flash=true
```

## Scheduling Messages

To schedule a message for later delivery:

```
scheduleTime=2024-12-25%2010:00
```

## Use Cases

* **Simple integrations**: Quick and easy SMS sending
* **Testing**: Test SMS functionality with minimal setup
* **Webhooks**: Trigger SMS from webhook endpoints
* **URL-based triggers**: Send SMS from URL parameters