List Senders
curl --request GET \
--url https://api.gliiv.com/v1/api/senders \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.gliiv.com/v1/api/senders"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.gliiv.com/v1/api/senders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gliiv.com/v1/api/senders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gliiv.com/v1/api/senders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gliiv.com/v1/api/senders")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gliiv.com/v1/api/senders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"senders": [
{
"id": "<string>",
"name": "<string>",
"balance": "<number>",
"user": {
"name": "<string>",
"id": "<string>"
},
"createdAt": "<string>",
"updatedAt": "<string>"
}
"..."
],
"total": "<number>"
}
{
"message": "Authentication required",
"status": 401
}
{
"message": "Internal server error",
"status": 500
}
Senders
List Senders
Retrieve a list of sender identities associated with your account
GET
/
v1
/
api
/
senders
List Senders
curl --request GET \
--url https://api.gliiv.com/v1/api/senders \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.gliiv.com/v1/api/senders"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.gliiv.com/v1/api/senders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gliiv.com/v1/api/senders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gliiv.com/v1/api/senders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gliiv.com/v1/api/senders")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gliiv.com/v1/api/senders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"senders": [
{
"id": "<string>",
"name": "<string>",
"balance": "<number>",
"user": {
"name": "<string>",
"id": "<string>"
},
"createdAt": "<string>",
"updatedAt": "<string>"
}
"..."
],
"total": "<number>"
}
{
"message": "Authentication required",
"status": 401
}
{
"message": "Internal server error",
"status": 500
}
This endpoint returns a list of sender IDs—such as alphanumeric names or registered short codes—that are authorized for use on your account.
Headers
string
required
Your secret API key used to authenticate the request.
Query Parameters
string
The field used to sort the results.Choices:
balance, createdAtstring
The direction of the sort.Choices:
asc, descnumber
default:1
The page number to retrieve for pagination.
number
default:50
The number of sender records to return per page.
Response Body
object[]
An array of authorized sender objects.
Show Sender Object Details
Show Sender Object Details
string
The unique identifier for the sender.
string
The alphanumeric label or short code.
number
The specific credit balance allocated to this sender.
object
string
The ISO 8601 timestamp of creation.
string
The ISO 8601 timestamp of the last update.
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>"
}
{
"message": "Authentication required",
"status": 401
}
{
"message": "Internal server error",
"status": 500
}
Last modified on July 18, 2026