# Receive SMS (MO) parameters

MO's should be returned to your MO endpoint in the following format:

```html
http://<your MOendpoint>?ORIGINATOR=MSISDN&CAMPAIGN=<campaign>&KEYWORD=<Keyword>&MESSAGE_TEXT=<incoming text>&REFERENCE=<Message-ID>&PROVIDER=<network>&RECIPIENT=<Shortcode>
```

When receiving SMS MO messages, the following parameters will be sent as part of the HTTP GET request:

| Parameter         | Description                                                                                                                                                                                         |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ORIGINATOR**    | Phone number of the originator (mobile phone) in international format (MSISDN) For example: `44700000000.`                                                                                          |
| **RECIPIENT**     | Service code / Shortcode number of the recipient.                                                                                                                                                   |
| **MESSAGE\_TEXT** | The SMS message sent by the Originator.                                                                                                                                                             |
| **PROVIDER**      | Identifies the telco provider (Telstra/Optus..)This field will be set to PREMIUM or left blank when receiving standard SMS messages For example: `Telstra.`                                         |
| **REFERENCE**     | The SMS Gateway will populate this parameter with our unique message identifier. Customers are encouraged to make sure no two messages are received with the same reference. For example: `ABC123.` |
| **VALUE**         | Billing amount in the lowest denomination of the currency. If “0” then the MO's are to be considered free to the sender.                                                                            |
| **KEYWORD**       | If applicable, the product/service keyword identified by the MNO.                                                                                                                                   |
| **CAMPAIGN**      | If applicable, the product/service campaign identified by the MNO.                                                                                                                                  |
