Check Sender Status

A sender's status may be obtained using this endpoint for emphasis on specific results on sender status and whitelisting status.

Endpoint

POST https://api.textcus.com/api/v2/senders/check-status

curl -X POST https://api.textcus.com/api/v2/senders/check-status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sender_name": "TextCus" }'

Headers

Authorization: Bearer API_KEY

Body Parameters

Parameters	Type	Description
sender_name string	Required	Your 11 character sender ID name. eg. TextCus

Sample Requests

PHP

<?php
$url = 'https://api.textcus.com/api/v2/senders/check-status';

$data = [
  'sender_name' => "TextCus", // 11 Characters Only
];

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data,
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer API_KEY' // Replace 'API_KEY' with your actual API key
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

?>

NodeJS

const axios = require('axios');

const data = {
  sender_name: "TextCus", // 11 Characters Only
};

const url = 'https://api.textcus.com/api/v2/senders/check-status';

axios.post(url, data, {
  headers: {
    'Authorization': 'Bearer API_KEY',  // Replace 'API_KEY' with your actual API key
    'Content-Type': 'application/json'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error);
});

Python

import requests

url = 'https://api.textcus.com/api/v2/senders/check-status'
data = {
    'sender_name': 'TextCus',  # 11 Characters Only
}
headers = {
    'Authorization': 'Bearer API_KEY',  # Replace 'API_KEY' with your actual API key
    'Content-Type': 'application/json'
}

response = requests.post(url, json=data, headers=headers)
print(response.text)

Dart

import 'dart:convert';
import 'package:http/http.dart' as http;

void checkSenderStatus() async {
  var url = Uri.parse('https://api.textcus.com/api/v2/senders/check-status');
  var data = {
    'sender_name': 'TextCus',  // 11 Characters Only
  };

  var response = await http.post(
    url,
    headers: {
      'Authorization': 'Bearer API_KEY',  // Replace 'API_KEY' with your actual API key
      'Content-Type': 'application/json',
    },
    body: jsonEncode(data),
  );

  if (response.statusCode == 200) {
    print('Response: ${response.body}');
  } else {
    print('Error: ${response.statusCode}');
  }
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpHeaders;
import java.net.http.HttpResponse.BodyHandlers;

public class CheckSenderStatus {
    public static void main(String[] args) {
        try {
            String url = "https://api.textcus.com/api/v2/senders/check-status";
            URL obj = new URL(url);
            HttpURLConnection con = (HttpURLConnection) obj.openConnection();
            con.setRequestMethod("POST");
            con.setRequestProperty("Authorization", "Bearer API_KEY"); // Replace 'API_KEY'
            con.setRequestProperty("Content-Type", "application/json");

            // Request body
            String jsonInputString = "{\"sender_name\": \"TextCus\"}";
            con.setDoOutput(true);
            try (OutputStream os = con.getOutputStream()) {
                byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
                os.write(input, 0, input.length);
            }

            int responseCode = con.getResponseCode();
            System.out.println("Response Code: " + responseCode);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

VB.Net

Imports System.Net
Imports System.Text
Imports System.IO

Module Module1
    Sub Main()
        Dim url As String = "https://api.textcus.com/api/v2/senders/check-status"
        Dim request As HttpWebRequest = CType(WebRequest.Create(url), HttpWebRequest)
        request.Method = "POST"
        request.ContentType = "application/json"
        request.Headers.Add("Authorization", "Bearer API_KEY") ' Replace 'API_KEY'

        ' JSON data
        Dim postData As String = "{""sender_name"": ""TextCus""}"
        Dim byteArray As Byte() = Encoding.UTF8.GetBytes(postData)

        request.ContentLength = byteArray.Length
        Dim dataStream As Stream = request.GetRequestStream()
        dataStream.Write(byteArray, 0, byteArray.Length)
        dataStream.Close()

        Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
        Dim reader As New StreamReader(response.GetResponseStream())
        Dim responseText As String = reader.ReadToEnd()
        Console.WriteLine(responseText)

        reader.Close()
        response.Close()
    End Sub
End Module

Sample Response

Success

{
    "status": true,
    "message": "Sender statuses for TextCus retrieved",
    "data": {
      "sender_name": "TextCus",
      "status": "yes",
      "whitelist_status": "approved"
    }
}

Errors

{
    "status": 401,
    "error": "Authentication invalid"
}, 

{
    "status": 401,
    "error": "Unauthorized: Invalid API Key"
}

Field	Meaning
status	"yes" = approved and usable. "no" = still pending.
whitelist_status	Network-level whitelisting, handled separately from approval.

Poll this after registering a sender rather than retrying /send and collecting failures.