Skip to main content
GET
/
api
/
v2
/
senderlist
Retrieve sender IDs for the authenticated account
curl --request GET \
  --url https://api.interactsms.com/api/v2/senderlist \
  --header 'Authorization: Bearer <token>'
[
  {
    "name": "FreeText",
    "type": 1
  },
  {
    "name": "353851234567",
    "type": 2
  },
  {
    "name": "Phonovation",
    "type": 0
  }
]

Authorizations

​
Authorization
string
header
required

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.

Response

Sender IDs retrieved successfully

​
name
string
required

The Sender ID value available on the account.

​
type
enum<integer>
required

The Sender ID type:

  • 0 = ComReg Sender ID
  • 1 = International non-ComReg approved Sender ID (wont send to Irish Numbers)
  • 2 = Numeric Sender ID
Available options:
0,
1,
2
Last modified on April 8, 2026