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

# List SMS Numbers

> Retrieve all phone numbers configured for SMS, along with their configuration and conversation counts. Pass `?channel=whatsapp` or `?channel=imessage` to return WhatsApp or iMessage configurations instead of SMS.

<Info>
  **Enterprise Feature** - SMS is only available on Enterprise plans. Contact your Bland representative for access.
</Info>

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Response

<ResponseField name="data" type="array">
  A list of phone numbers with SMS configurations.
</ResponseField>

<ResponseField name="data[].phone_number" type="string">
  The E.164 formatted phone number assigned to the user.
</ResponseField>

<ResponseField name="data[].sms_config" type="object">
  The configuration used when handling inbound SMS messages.
</ResponseField>

<ResponseField name="data[].sms_config.webhook" type="string">
  When the agent sends a response, we’ll send the message details in a POST request to the URL you specify here, along with chat history.
</ResponseField>

<ResponseField name="data[].sms_config.request_data" type="object">
  Request data fields are available to the AI agent during the call when referenced in the associated pathway or task.
</ResponseField>

<ResponseField name="data[].sms_config.time_out" type="number">
  Maximum time to wait for a response. Default is no timeout.
</ResponseField>

<ResponseField name="data[].sms_config.messaging_service_sid" type="string">
  Twilio Messaging Service SID, if set.
</ResponseField>

<ResponseField name="data[].sms_config.objective" type="string">
  The assistant’s objective or system instruction.
</ResponseField>

<ResponseField name="data[].sms_config.tools" type="array">
  A list of tools available to the assistant.
</ResponseField>

<ResponseField name="data[].sms_config.temperature" type="number">
  The model’s temperature setting, controlling creativity.
</ResponseField>

<ResponseField name="data[].sms_config.pathway_id" type="string">
  The ID of the linked conversational pathway (if any).
</ResponseField>

<ResponseField name="data[].sms_config.pathway_version" type="string">
  The specific version of the pathway to use.
</ResponseField>

<ResponseField name="data[].sms_config.start_node_id" type="string">
  The ID of the first node to enter in the pathway.
</ResponseField>

<ResponseField name="data[].sms_config.restart_after_end_call" type="boolean">
  When `true`, a new conversation is automatically started if the user texts after the current conversation has ended. When `false`, subsequent messages are stored in the ended conversation without triggering a new reply.
</ResponseField>

<ResponseField name="data[].sms_config.timezone" type="string">
  The timezone used for time-based variables in the conversation (e.g. `"America/New_York"`).
</ResponseField>

<ResponseField name="data[].sms_config.citation_schema_ids" type="string[]">
  IDs of citation schemas configured for this number. Citations are extracted when conversations end. See [Citations](/enterprise-features/citations).
</ResponseField>

<ResponseField name="data[].sms_config.disposition_ids" type="string[]">
  IDs of outcomes configured for this number. Outcomes are evaluated when conversations end. See [Outcomes](/tutorials/outcomes).
</ResponseField>

<ResponseField name="data[].sms_config.summary_prompt" type="string">
  Custom prompt used to generate a conversation summary when the conversation ends.
</ResponseField>

<ResponseField name="data[].conversation_count" type="integer">
  The number of SMS conversations handled by this number.
</ResponseField>

<ResponseField name="errors" type="null">
  Always `null` on success.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "phone_number": "+14155552671",
        "sms_config": {
          "webhook": "https://example.com/sms-webhook",
          "request_data": { "ref": "campaign_123" },
          "time_out": 15,
          "messaging_service_sid": "MG1234567890abcdef",
          "objective": "Provide quick support to customers.",
          "tools": ["lookup", "escalate"],
          "temperature": 0.7,
          "pathway_id": "abc123",
          "pathway_version": "latest",
          "start_node_id": "entry-node",
          "restart_after_end_call": true,
          "timezone": "America/New_York",
          "citation_schema_ids": ["b0477cba-1c97-4105-8ac9-46cb8eae5cf1"],
          "disposition_ids": ["d1234567-abcd-1234-efgh-123456789012"],
          "summary_prompt": "Summarize the key points and outcome of this conversation."
        },
        "conversation_count": 34
      }
    ],
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)