# Request to receive the list of scheduled SMS

## Request to receive the list of scheduled SMS

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/xml/list_scheduled.php`

#### Headers

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| Content-type<mark style="color:red;">\*</mark> | String | **`text/xml; charset=utf-8;`** |

#### Request Body

| Name                                             | Type   | Description                                                                                                                                                                    |
| ------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| login.value<mark style="color:red;">\*</mark>    | String | Your login in the system                                                                                                                                                       |
| scheduled.page<mark style="color:red;">\*</mark> | Int    | Page number. The entire list of scheduled SMS is divided into pages. You cannot request the whole list. You can only request an individual page. The numbering starts with one |
| token.value<mark style="color:red;">\*</mark>    | String | You can use a secret key instead of login and password. To obtain it, please contact your manager                                                                              |
| password.value<mark style="color:red;">\*</mark> | String | Your password in the system                                                                                                                                                    |

{% tabs %}
{% tab title="200: OK If a valid XML document is received" %}

```xml
<?xml version="1.0" encoding="utf-8" ?>
<response>
     <phones page="1" num_pages="100">
          <scheduled id_sms="1234" time_put_turn="2011-11-14 12:42:40" originator="kosty" phone="79612242243" type_sms="sms" text_sms="ТекстSMS" count_sms="2" name_delivery="Newsletter title" time_send="2011-11-14 21:00" validity_period="2011-11-17 21:00:00" />
          <scheduled id_sms="1235" time_put_turn="2011-11-14 12:42:40" originator="kosty" phone="79612242244" type_sms="sms" text_sms="ТекстSMS" count_sms="2" name_delivery="Newsletter title" time_send="2011-11-14 21:00" validity_period="2011-11-17 21:00:00" />
          …
     </phones>
</response>
```

{% endtab %}

{% tab title="400: Bad Request If an error occurs in the sent XML document" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>Error message</error>
</response>
```

{% endtab %}
{% endtabs %}

### Deciphering parameters in query responses

<table><thead><tr><th width="164.33333333333331">Parameter</th><th width="164">Data type</th><th>Description</th></tr></thead><tbody><tr><td>phones.page</td><td>Int</td><td>Page number</td></tr><tr><td>phones.num_pages</td><td>Int</td><td>Total pages</td></tr><tr><td>phones.scheduled.id_sms</td><td>Int</td><td>SMS number. Used to delete a scheduled SMS</td></tr><tr><td>phones.scheduled.time_put_turn</td><td>Int</td><td>Time to add to the scheduler</td></tr><tr><td>phones.scheduled.originator</td><td>String</td><td>SMS sender. This is the value that will be displayed on the subscriber's phone in the SMS from field</td></tr><tr><td>phones.scheduled.phone</td><td>Int</td><td>Number of the subscriber to whom the SMS is addressed</td></tr><tr><td>phones.scheduled.type</td><td>String</td><td><p>SMS message type: </p><ul><li>sms - regular SMS </li><li>flashsms - Flash SMS </li><li>wappush - WAP-Push </li><li>vcard - business card (vCard)</li></ul></td></tr><tr><td>phones.scheduled.text_sms</td><td>String</td><td>SMS text</td></tr><tr><td>phones.scheduled.count_sms</td><td>Int</td><td>Number of SMS message parts</td></tr><tr><td>phones.scheduled.name_delivery</td><td>String</td><td>Newsletter title</td></tr><tr><td>phones.scheduled.time_send</td><td>Date</td><td><p>The date and time of the shipment in the format:</p><p>YYYY-MM-DD HH:MM</p><p>where,<br>   YYYY-year,<br>   MM-month,<br>   DD-day,<br>   HH-hours, </p><p>   MM-minutes</p></td></tr><tr><td>phones.scheduled.validity_period</td><td>Date</td><td><p>The date and time after which no attempts will be made to deliver SMS in the format:</p><p>  YYYY-MM-DD HH:MM:SS</p><p>where,<br>   YYYY-year,<br>   MM-month,<br>   DD-day,<br>   HH-hours, </p><p>   MM-minutes</p><p>   SS-seconds</p></td></tr><tr><td>error</td><td>String</td><td><p>The error text can take the following values:</p><ul><li>Incorrect XML document format </li><li>Incorrect login or password </li><li>POST data is missing</li></ul></td></tr></tbody></table>

### Example XML request

```xml
<?xml  version="1.0" encoding="utf-8" ?>
<request>
     <security>
          <login value="login" />
          <password value="password" />
     </security>
     <scheduled page=”1”/>
</request>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.webcom.mobi/en/sposoby-vzaimodeistviya-s-a2p-platformoi/xml-specification/request-to-receive-the-list-of-scheduled-sms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.