> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hologram.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send and receive SMS using the REST API

> You can use the Hologram REST API to send and receive SMS messages on your device. Use the SMS incoming endpoint to send a message to a device and read SMS responses via Data Engine logs.

## How to send and receive SMS using the REST API

Use the SMS incoming endpoint to send a message to a device.

```bash theme={null}
curl --request POST \
  'https://dashboard.hologram.io/api/1/sms/incoming' \
  -u apikey:YOUR_HOLOGRAM_API_KEY \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "deviceid": YOUR_DEVICE_ID,
    "body": "Hello world!"
  }'
```

<Note>
  **Note:** Messages originate from a +44 number. Replies from the device appear in logs.
</Note>

## View device SMS replies from logs

Query Data Engine CSR logs for SMS activity.

```bash theme={null}
curl --request GET \
  'https://dashboard.hologram.io/api/1/csr/rdm?deviceid=YOUR_DEVICE_ID' \
  -u apikey:YOUR_HOLOGRAM_API_KEY
```

The `data` field is Base64-encoded; decode to read the text payload.

## Related actions

<Card title="Send TCP/UDP messages to a device" href="/dashboard/sim-actions/send-messages-to-sims" horizontal />

<Card title="Dashboard bulk actions" href="/dashboard/sim-actions/send-messages-to-sims" horizontal>
  Send SMS messages, or TCP or UDP cloud messages to your SIMs. No SIM limit.
</Card>