SMSCash

Получить SMS в JSON — API SMSCash

Возвращает коды, тексты, отправителей и время получения SMS.

Справочник методов API

Получить SMS в JSON

Возвращает коды, тексты, отправителей и время получения SMS.

API-ключ в запросе

GET https://smscash.org/stubs/handler_api.php?api_key=APIKEY&action=getSmsFull&id=1000000000
ПараметрТипОбязательностьОписаниеПример
api_keystringОбязательныйAPI-ключ. Также можно передать в заголовке X-API-Key или Authorization: Bearer.APIKEY
actionstringОбязательныйНазвание методаgetSmsFull
idintegerОбязательныйИдентификатор активации1000000000

Пример ответа

{
  "success": true,
  "session_id": 1000000000,
  "phone": "447700900123",
  "status": "completed",
  "sms_count": 1,
  "sms": [
    {
      "id": "00000000-0000-4000-a000-000000000001",
      "sender": "mm",
      "code": "482761",
      "text": "Your verification code: 482761",
      "received_at": "2026-09-10T10:00:00Z",
      "country": {
        "code": "GB",
        "name": "Великобритания"
      },
      "service": {
        "code": "mm",
        "name": "Сервис"
      },
      "provider": {
        "code": "1",
        "name": "Оператор 1"
      }
    }
  ]
}

Доступны только сообщения активаций этого API-ключа. Удалённые сообщения и сообщения с истёкшим сроком хранения не возвращаются.

Названия сохранены на момент получения сообщения. Последующее переименование справочника не меняет историю.

Ошибки

BAD_KEY — Неверный, отозванный ключ или запрещённый IP. Проверьте ключ, доступ и IP-адрес сервера.

BANNED — Аккаунт заблокирован. Обратитесь в поддержку.

BAD_ACTION — Неизвестный метод или отсутствующий обязательный параметр. Исправьте action и обязательные параметры.

ERROR_RATE_LIMIT — Превышена частота или число одновременных запросов. Снизьте частоту и учтите Retry-After.

ERROR — Временная ошибка сервера. Примените задержку с увеличением интервала; выдачу повторяйте с тем же Idempotency-Key.

NO_ACTIVATION — Активация не найдена в доступе этого ключа. Проверьте id и ключ, которым получен номер.