---
title: "Get incoming messages"
method: GET
path: "/3rdparty/v1/inbox"
tags: ["User", "Inbox"]
---

# Get incoming messages

`GET /3rdparty/v1/inbox`

Retrieves incoming messages with filtering and pagination.

## Query parameters

- `type` 'SMS' | 'DATA_SMS' | 'MMS' | 'MMS_DOWNLOADED'
- `limit` integer
- `offset` integer
- `from` string, date-time
- `to` string, date-time
- `deviceId` string

## Response `200`

A list of incoming messages

- SmsgatewayIncomingMessage[]
  - `contentPreview` string, required — Message body preview or metadata
  - `createdAt` string, date-time, required — Message received timestamp
  - `id` string, required — Incoming message ID
  - `recipient` string — Recipient phone number on the device
  - `sender` string, required — Incoming sender phone number
  - `simNumber` integer — SIM slot number
  - `type` 'SMS' | 'DATA_SMS' | 'MMS' | 'MMS_DOWNLOADED', required

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error
- `501` — Not implemented

---

[API](https://skmtc.dev/sms-gate/apis/smsgate-api.md) · [All operations](https://skmtc.dev/sms-gate/apis/smsgate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sms-gate/smsgate-api/revisions/56a6604029f1/schema)