TextCus API Documentation
  • Introduction
  • OVERVIEW
    • Send SMS
      • Quick Send
      • Send Multiple SMS
    • Sender IDs
      • List Senders
      • Add Senders
    • Account Balance
    • One Time Password (OTP)
Powered by GitBook
On this page
  • Getting Started
  • Overview
  • Authentication
  • Requests and Response
  • Response Formats
  • Status Codes and Interpretation

Introduction

NextSend SMS

Last updated 8 months ago

Our SMS APIs are designed to integrate seamlessly with your systems and applications and are supported by our dependable bulk SMS gateway. This document is a comprehensive reference for all the features accessible to you through our APIs for sending SMS messages.

Getting Started

To send SMS using our APIs, you need to have a TextCus SMS Messaging account.

Step 1: Create a TextCus SMS Messaging account (if you don't already have one)

  • Visit to create a new SMS account.

  • Follow the steps provided to activate your account.

Overview

Our APIs are designed to integrate seamlessly with your systems and applications. This document is a comprehensive reference for all the features accessible through our APIs for adding and fetching data. It's designed around the primary resources you'll need most frequently and is made with RESTful standards in mind.

Authentication

Reference your API Key

Reference your API Key

  • Log in to your TextCus SMS Messaging account

  • Go to API > API Access or visit

  • Copy your API key for future reference

The following format should be used for authorisation headers:

Authorization: Bearer API_KEY

Sample Authorization Header

Authorization: Bearer 92857043717beff382ae75c8dc7514162f04

curl -H "Authorization: Bearer API_KEY" \
     https://sms.textcus.com/api/v2/user/authenticate

Requests and Response

The format of the response and request payloads is JSON. Responses will always have application/json as their content type. Each response will typically follow this format:

Response Formats

Response
Data type
Description

status

number

The HTTP status code indicating a status operation.

message

string

This gives you detailed explaination on the request sent. The interpretation of the status code.

data

object

An object holding any data that the API returned after receiving the request.

Status Codes and Interpretation

Status Code
Interpretation

200

Standard for successful request.

201

Used for requests as a result of creation.

204

Indicates that a request has succeeded or been processed.

400

For bad requests.

401

For unathorized.

402

For payment required.

404

For not found.

500

For internal server errors.

POST

To add new user data to the system, use this request.

GET

To add and retrieve user data from the system, use this request.

https://sms.textcus.com/signup
https://sms.textcus.com/api/access