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

# SMS Reporting

> Read aggregate results from your SMS outreach (coming soon).

<Warning>
  **Coming soon.** These endpoints are planned but not yet active. The shapes below may change before
  launch. Today only the [Walks](/api-reference/walks) endpoints are live.
</Warning>

The SMS API is **reporting-only** — it reads results from campaigns you've already sent. It does
**not** send messages. Sending stays inside Culper, where A2P 10DLC compliance, opt-outs, and quiet
hours are enforced.

<Info>
  Sending texts through an API is intentionally not offered. Political SMS is tightly regulated (TCPA,
  carrier A2P rules); keeping sends inside Culper is what keeps campaigns compliant.
</Info>

## Planned endpoints

```http theme={null}
GET /api/v1/sms/campaigns
GET /api/v1/sms/campaigns/{id}
```

### List SMS campaigns — planned response

<ResponseField name="id" type="string">The SMS campaign's unique id.</ResponseField>
<ResponseField name="name" type="string">Campaign name.</ResponseField>
<ResponseField name="sent" type="integer">Messages sent.</ResponseField>
<ResponseField name="delivered" type="integer">Messages confirmed delivered.</ResponseField>
<ResponseField name="failed" type="integer">Messages that failed to deliver.</ResponseField>
<ResponseField name="replies" type="integer">Inbound replies received.</ResponseField>
<ResponseField name="opt_outs" type="integer">Recipients who opted out (STOP).</ResponseField>
<ResponseField name="sent_at" type="string">ISO-8601 timestamp of the send.</ResponseField>

Requires the `sms:read` scope. Want early access? Let the Culper team know.