Get Sender - Gliiv Docs

Get Sender Details API: Fetch SMS Identity Data

curl --request GET \
  --url https://api.gliiv.com/v1/api/senders/{senderId} \
  --header 'X-API-Key: <x-api-key>'

import requests

url = "https://api.gliiv.com/v1/api/senders/{senderId}"

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/{senderId}', 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/{senderId}",
  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/{senderId}"

	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/{senderId}")
  .header("X-API-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gliiv.com/v1/api/senders/{senderId}")

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

{
    "id": "<string>",
    "name": "<string>",
    "balance": "<number>",
    "user": {
        "name": "<string>",
        "id": "<string>"
    },
    "createdAt": "<string>",
    "updatedAt": "<string>"
}

{
    "message": "Invalid input provided",
    "validationErrors": {
        "senderId": "Please provide a valid sender ID"
    },
    "status": 400
}

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

{
  "message": "Sender not found",
  "status": 404
}

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

GET

api

senders

{senderId}

Get Sender Details API: Fetch SMS Identity Data

curl --request GET \
  --url https://api.gliiv.com/v1/api/senders/{senderId} \
  --header 'X-API-Key: <x-api-key>'

import requests

url = "https://api.gliiv.com/v1/api/senders/{senderId}"

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/{senderId}', 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/{senderId}",
  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/{senderId}"

	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/{senderId}")
  .header("X-API-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gliiv.com/v1/api/senders/{senderId}")

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

{
    "id": "<string>",
    "name": "<string>",
    "balance": "<number>",
    "user": {
        "name": "<string>",
        "id": "<string>"
    },
    "createdAt": "<string>",
    "updatedAt": "<string>"
}

{
    "message": "Invalid input provided",
    "validationErrors": {
        "senderId": "Please provide a valid sender ID"
    },
    "status": 400
}

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

{
  "message": "Sender not found",
  "status": 404
}

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

This endpoint returns the full details of a single sender identity, including its current balance and ownership information.

Path Parameters

senderId

string

required

The unique identifier of the sender you want to retrieve.

Headers

X-API-Key

string

required

Your secret API key used to authenticate the request.

Response Body

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.

{
    "id": "<string>",
    "name": "<string>",
    "balance": "<number>",
    "user": {
        "name": "<string>",
        "id": "<string>"
    },
    "createdAt": "<string>",
    "updatedAt": "<string>"
}

{
    "message": "Invalid input provided",
    "validationErrors": {
        "senderId": "Please provide a valid sender ID"
    },
    "status": 400
}

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

{
  "message": "Sender not found",
  "status": 404
}

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

List All Senders Send SMS

​Path Parameters

​Headers

​Response Body

Path Parameters

Headers

Response Body