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

# List the SMS sender this org can bind for sequence SMS steps

> List the SMS number this organization can bind as the sender for sequence SMS steps, with an eligibility verdict and the reason when it cannot be bound.

An organization has one SMS number, so the list holds at most one sender. Bind its `sender_id` with [set senders](https://docs.open.cx/api-reference/sequences/set-senders.md) on the `sms` channel; a sequence with an SMS step cannot launch until it is bound.

The list is empty until the SMS channel is [connected](https://docs.open.cx/sms/connect-sms.md). `ineligible_reason: "disabled"` means the channel is switched off: switch it back on before binding.


## OpenAPI

````yaml get /sequences/sms-senders
openapi: 3.1.0
info:
  title: OpenCX API
  description: >

    OpenCX is an AI-powered, all-in-one platform for customer support and
    outbound communications.


    Use this API to manage your OpenCX organization's AI agents, actions,
    conversations, contacts, and more.


    To get started, generate a new API key from the dashboard.


    ## Authentication

    All API endpoints require authentication using a Bearer token. You can
    generate an API key from your OpenCX dashboard.


    ## Rate Limiting

    API requests are rate limited to ensure fair usage. The current limits are:

    - 100 requests per minute for standard endpoints

    - 1000 requests per minute for streaming endpoints


    ## Error Handling

    The API uses standard HTTP status codes and returns detailed error messages
    in the response body.
  version: 1.0-beta
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: http://localhost:8080
    description: Development
  - url: https://api.open.cx
    description: Production
security:
  - bearerAuth: []
paths:
  /sequences/sms-senders:
    get:
      summary: List the SMS sender this org can bind for sequence SMS steps
      description: >-
        The organization's SMS number with its bindability verdict. An
        organization has one SMS number, so this lists at most one sender. An
        `eligible` sender is accepted by setSequenceSenders on the sms channel
        (bind its `sender_id`); an ineligible one carries the reason —
        `disabled` means the SMS channel is switched off. Empty when the
        organization has no SMS channel connected.
      operationId: listSmsSenders
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsSendersDto'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    SmsSendersDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/SmsSendersDto'
      type: object
      properties:
        senders:
          type: array
          items:
            type: object
            properties:
              sender_id:
                type: string
                description: >-
                  The SMS channel's id — what set_sequence_senders binds for
                  sms.
              from_number:
                type: string
                description: The number people see the text come from.
              eligible:
                type: boolean
                description: Whether the engine will accept this sender at all.
              ineligible_reason:
                type: string
                enum:
                  - disabled
            required:
              - sender_id
              - from_number
              - eligible
            additionalProperties: false
      required:
        - senders
      additionalProperties: false
    ErrorDto:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.