SendexaDocs
Dash

List Sender IDs

Retrieve the sender IDs registered to your business, with optional filtering by status, type, and name.

Filter by Status, Type, or Name

Narrow results with status, type, and a case-insensitive search substring — combine as many as you need.

Usage Stats Included

Each sender ID carries totalMessages and totalCampaigns so you can spot unused registrations.

GET
/v1/sender-ids
Stable

Query Parameters

ParameterTypeDescription
statusstringPENDING | APPROVED | REJECTED | UNDER_REVIEW
typestringSHARED | DEDICATED | SHORT_CODE | ALPHANUMERIC
searchstringCase-insensitive name substring
limitnumberPage size — default 50
offsetnumberPage offset — default 0

Response

JSON
{
  "success": true,
  "data": [
    {
      "id": "cmq804x70000avskxfqpc33yz",
      "name": "YourBrand",
      "useCase": "Order confirmations and delivery updates.",
      "type": "ALPHANUMERIC",
      "status": "APPROVED",
      "approvedBy": "admin_01abc",
      "createdAt": "2026-07-01T09:00:00.000Z",
      "updatedAt": "2026-07-02T11:15:00.000Z",
      "stats": {
        "totalMessages": 128,
        "totalCampaigns": 3
      }
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "pages": 1
  }
}

Try It Yourself

GET
https://api.sendexa.co/v1/sender-ids?status=APPROVED

Code Examples

Bash
curl -X GET 'https://api.sendexa.co/v1/sender-ids?status=APPROVED&limit=20' \
  -H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN'