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

# List Sender IDs

> Returns the list of Sender IDs available to the authenticated user's account.

Each sender entry includes:
- `name` — the Sender ID value
- `type` — the Sender ID type:
  - `0` = ComReg Sender ID
  - `1` = International non-ComReg approved Sender ID
  - `2` = Numeric Sender ID

This endpoint is useful when validating which Sender IDs can be used in campaign requests.




## OpenAPI

````yaml GET /api/v2/senderlist
openapi: 3.1.2
info:
  title: Phonovation SMS API Suite
  description: >
    This API suite consists of two separate APIs:


    1. **Phonovation Auth API**: Used for authentication via
    `https://auth.interactsms.com`. This API issues JWT tokens for use in
    authenticated API requests.


    2. **Phonovation SMS API**: Provides bulk SMS functionality via
    `https://api.interactsms.com`. Requires authentication via the Auth API.
  version: 2.0.0
  contact:
    name: Phonovation Support
    email: support@phonovation.com
servers:
  - url: https://api.interactsms.com
    description: Phonovation SMS API Server
security: []
tags:
  - name: Authentication
    description: Endpoints related to user authentication and token management.
  - name: API
    description: Phonovation SMS API endpoints.
  - name: Webhooks
    description: Webhook payloads sent by Phonovation to customer-configured endpoints.
paths:
  /api/v2/senderlist:
    get:
      tags:
        - API
      summary: Retrieve sender IDs for the authenticated account
      description: >
        Returns the list of Sender IDs available to the authenticated user's
        account.


        Each sender entry includes:

        - `name` — the Sender ID value

        - `type` — the Sender ID type:
          - `0` = ComReg Sender ID
          - `1` = International non-ComReg approved Sender ID
          - `2` = Numeric Sender ID

        This endpoint is useful when validating which Sender IDs can be used in
        campaign requests.
      operationId: GetSenderList
      responses:
        '200':
          description: Sender IDs retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SenderListResponse'
              examples:
                senderListResponse:
                  summary: Example sender list
                  value:
                    - name: FreeText
                      type: 1
                    - name: '353851234567'
                      type: 2
                    - name: Phonovation
                      type: 0
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignResponse'
              examples:
                unauthorizedResponse:
                  summary: Unauthorized response
                  value:
                    success: false
                    message: Unauthorized.
                    errors:
                      - 401 Unauthorized
      security:
        - OAuth2Password: []
        - BearerAuth: []
      servers:
        - url: https://api.interactsms.com
          description: Phonovation SMS API Server
components:
  schemas:
    SenderListResponse:
      type: array
      description: A list of Sender IDs available to the authenticated account.
      items:
        $ref: '#/components/schemas/SenderId'
    CampaignResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type:
            - string
            - 'null'
        errors:
          type:
            - array
            - 'null'
          items:
            type: string
    SenderId:
      type: object
      required:
        - name
        - type
      properties:
        name:
          type: string
          description: The Sender ID value available on the account.
        type:
          type: integer
          description: >
            The Sender ID type:

            - 0 = ComReg Sender ID

            - 1 = International non-ComReg approved Sender ID (wont send to
            Irish Numbers)

            - 2 = Numeric Sender ID
          enum:
            - 0
            - 1
            - 2
  securitySchemes:
    OAuth2Password:
      type: oauth2
      description: >-
        Use the OAuth2 password flow to obtain an access token for the
        Phonovation SMS API.
      flows:
        password:
          tokenUrl: https://auth.interactsms.com/token
          scopes: {}
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Use the Password grant_type flow to get a JWT access token from
        https://auth.interactsms.com/token. Pass it as a Bearer token in the
        Authorization header to access the API.

````