Skip to main content
GET
/
v1
/
api
/
senders
List All Senders
curl --request GET \
  --url https://api.gliiv.com/v1/api/senders \
  --header 'X-API-Key: <x-api-key>'
{
    "senders": [
        {
            "id": "<string>",
            "name": "<string>",
            "balance": "<number>",
            "user": {
                "name": "<string>",
                "id": "<string>"
            },
            "createdAt": "<string>",
            "updatedAt": "<string>"
        }
        "..."
    ],
    "total": "<number>"
}

Documentation Index

Fetch the complete documentation index at: https://www.gliiv.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint returns a list of all sender IDs—such as alphanumeric names or registered short codes—that are authorized for use on your account.

​
Headers

​
X-API-Key
string
required
Your secret API key used to authenticate the request.

​
Query Parameters

​
sortBy
string
The field used to sort the results.Choices: balance, createdAt
​
sortDirection
string
The direction of the sort.Choices: asc, desc
​
page
number
default:1
The page number to retrieve for pagination.
​
limit
number
default:50
The number of sender records to return per page.

​
Response Body

​
senders
object[]
An array of authorized sender objects.
​
total
number
The total count of sender identities available.
{
    "senders": [
        {
            "id": "<string>",
            "name": "<string>",
            "balance": "<number>",
            "user": {
                "name": "<string>",
                "id": "<string>"
            },
            "createdAt": "<string>",
            "updatedAt": "<string>"
        }
        "..."
    ],
    "total": "<number>"
}