GetList

Метод GetList

Примените метод GetList, чтобы получить информацию об исходящих и входящих сообщениях по заданным параметрам.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/messaging/v1/GetList

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Можно передать пустой запрос — тогда вы получите информацию обо всех SMS этого приложения без применения фильтров поиска.

MCC/MNC коды оператора

• MCC (Mobile Country Code) — код страны, в которой находится оператор мобильной связи. Состоит из 3 цифр.
• MNC (Mobile Network Code) — код мобильной сети (оператора), следует после MCC. Состоит из 2 или 3 цифр, уникален для каждого оператора он уникален.

Комбинация MCC + MNC + наименование оператора позволяет однозначно определить сеть. Эти коды унифицированы — вы можете воспользоваться любым справочником, чтобы найти нужный код.

Channel

CategoryType

SortOrder

OrderByDate/OrderBySegmentsCount

Выходные параметры

Direction

BillingStatus

DeliveryStatus

Status

Channel

CategoryType

Примеры

Входные параметры (для SMS и УПН → SMS):

{
   "message_id": 535103102366598674,
   "limit": 100,
   "offset": 0,
   "number": "79813330013",
   "sender": "79813340013",
   "direction": 2,
   "delivery_status": 3,
   "billing_status": 2,
   "status": 3,
   "date_gte": "2024-10-01T10:00:56.759Z",
   "date_lte": "2024-12-10T10:00:56.759Z",
   "date_sent_received_gte":"2023-01-20T11:30:01.335Z",
   "date_sent_received_lte":"2023-01-20T11:39:01.335Z",
   "receiver": "79873558880",
   "receiver_mcc": "250",
   "receiver_mnc": "1",
   "receiver_mobile_operator": "MTS",
   "category": 1,
   "campaign_id": "12345",
   "campaign_name": "test",
   "sort": {
       "order_by_date": 1
   },
   "price_gte": 1.5,
   "price_lte": 10.12,
}

Входные параметры (для Telegram Verify):

{
   "message_id": 582622948376971821,
   "limit": 100,
   "offset": 0,
   "delivery_status": 3,
   "billing_status": 2,
   "status": 3,
   "date_gte": "2025-09-02T06:00:03Z",
   "date_lte": "2025-09-02T08:00:03Z",
   "sort": {
       "order_by_date": 1
   }
}

Выходные параметры (для SMS и УПН → SMS):

{
   "messages": [
       {
           "message_id": "535103152366598674",
           "application_uuid": "6cb49297-8cd2-4f34-8e8b-856679a82437",
           "date": "2024-10-09T12:12:18.303Z",
           "date_sent_received": "2024-10-09T12:12:18.303Z",
           "number": "79813330013",
           "sender": "79813340013",
           "receiver": "79873558880",
           "text": "МТС Exolve — конструктор омниканальных диалогов для бизнеса",
           "direction": 2,
           "segments_count": 1,
           "billing_status": 2,
           "delivery_status": 3,
           "channel": 1,
           "status": 3,
           "sender_mcc": "250",
           "sender_mnc": "42",
           "sender_mobile_operator": "MTT",
           "receiver_mcc": "250",
           "receiver_mnc": "1",
           "receiver_mobile_operator": "MTS",
           "campaign_id": "12345",
           "campaign_name": "test",
           "category": 1,
           "price": 1.5
       }
   ]
}

Выходные параметры (для Telegram Verify):

{
    "message_id": "582622948376971821",
    "application_uuid": "6cb49297-8cd2-4f34-8e8b-856679a82437",
    "date": "2025-09-02T07:59:03Z",
    "receiver": "79873558881",
    "text": "1234",
    "direction": 2,
    "segments_count": 1,
    "billing_status": 2,
    "delivery_status": 3,
    "channel": 4,
    "status": 3,
    "date_sent_received": "2025-09-02T07:58:58.823Z"
}

Возможные ошибки