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

# Get SMS Settings

> Get the SMS add-on status for a company

# Get SMS Settings

Returns the company's SMS add-on status: whether SMS is enabled, plan eligibility, credit balance, brand prefix, phone numbers, and whether SMS sequence steps will actually send.

Check this before adding SMS steps to sequences. Steps added while SMS is not ready are stored normally but skip at runtime until the add-on is enabled and a number is active.

## Request

No request body. Pass `X-Company-Id` if your API key has access to multiple companies.

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/sms/settings" \
  -H "Authorization: Bearer seq_live_xxx"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "sms": {
      "enabled": true,
      "planEligible": true,
      "creditsBalance": 4200,
      "brandPrefix": "Acme",
      "numbers": [{ "e164": "+18885550123", "status": "active" }],
      "readyToSend": true
    },
    "message": "SMS is enabled and ready to send."
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Company not found"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to load SMS settings"
  }
  ```
</ResponseExample>