---
title: "View received SMS"
method: POST
path: "/sms/view-received"
tags: ["SMS"]
---

# View received SMS

`POST /sms/view-received`

View received SMS messages.

## Request body

- object
  - `start_date` string, date — ISO-8601 formatted datetime which defaults to 7 days ago at midnight. The range will be inclusive of start_date and exclusive of end_date. Timezone is UTC.
  - `end_date` string, date — ISO-8601 formatted datetime which defaults to now. Timezone is UTC.
  - `unix_start` integer — Deprecated: this is a legacy method of selecting the start of the search period as a unix timestamp. This can be left empty to use the start_date.
  - `unix_end` integer — Deprecated: this is a legacy method of selecting the end of the search period as a unix timestamp. This can be left empty to use the end_date.
  - `username` string — If passed will filter the results based on the username information on the message
  - `subaccount_id` string — If you wish to make this API call on behalf of a subaccount then include its unique ID here.

## Response `200`

SMS Messages

- object
  - `data` object
    - `request_id` string
    - `messages` object[], required
      - `source_address` string, required
      - `destination_address` string, required
      - `timestamp` string, required
      - `content` string, required
      - `message_id` string, required
      - `username` string, required

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/versions/1ba6b25eebb9/schema)