List All 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
}

GET

api

senders

List All 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 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.

Show Sender Object Details

string

The unique identifier for the sender.

name

string

The alphanumeric label or short code.

balance

number

The specific credit balance allocated to this sender.

user

object

Information about the owner of the sender identity.

Show User Details

name

string

The name of the user.

string

The unique identifier of the user.

createdAt

string

The ISO 8601 timestamp of creation.

updatedAt

string

The ISO 8601 timestamp of the last update.

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>"
}

{
  "message": "Authentication required",
  "status": 401
}

{
    "message": "Internal server error",
    "status": 500
}

Authentication Get Sender

​Headers

​Query Parameters

​Response Body

Headers

Query Parameters

Response Body