---
# @generated by sylphx-gen. Do not edit.
title: "Inbound sms"
description: "The `inbound_sms` collection of Sylphx Notify: An Inbound SMS is one text a bound number received, kept as evidence."
type: reference
product: notifications
summary: "An Inbound SMS is one text a bound number received, kept as evidence."
updated: 2026-09-28
order: 900
---

An Inbound SMS is one text a bound number received, kept as evidence. The body is cleared when the environment's tier retention expires; the carrier's message id stays, so a replay after that never records the message again. Consumers read the feed in `sequence` order.

**Service** Sylphx Notify · **Resource type** `notify.sylphx.com/InboundSms` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/sms_numbers/{sms_number}/inbound_sms/{inbound_sms}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/sms_numbers/{sms_number}/inbound_sms/{inbound_sms}`. |
| `uid` | `string` | `isms_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `sequence` | `int64` | The feed position, increasing within the environment; filter `sequence > N` to resume after the last one handled. Output only. |
| `carrier_message_id` | `string` | The carrier's id for this message; the dedupe key on the number binding. Output only. |
| `sender_number` | `string` | The sender, in E.164 when the carrier gave one. Output only. |
| `recipient_number` | `string` | The number the message was sent to, in E.164. Output only. |
| `text` | `string` | The text. Empty once retention has cleared it. Output only. |
| `segments` | `int32` | How many segments the carrier counted. Output only. |
| `receive_time` | `timestamp` | When the carrier says it received the message. Output only. |
| `cleared` | `bool` | The text has been cleared by retention; the dedupe key stays. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/inbound_sms#get) | Gets one inbound SMS. |
| `GET` | [`list`](/docs/api/inbound_sms#list) | Lists a number's inbound SMS in feed order, oldest first. |

## get

Gets one inbound SMS.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/sms_numbers/sms-number/inbound_sms/inbound-sms` · scope `notify:read` · effect `read` · [Request, response and examples](/docs/api/inbound_sms/get)

## list

Lists a number's inbound SMS in feed order, oldest first.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/sms_numbers/sms-number/inbound_sms` · scope `notify:read` · effect `read` · paginated · [Request, response and examples](/docs/api/inbound_sms/list)