Introduction

Welcome to the Teruza API Documentation! Below is a list of all available API calls.

Getting Started

API Key

You will require an API Key in order to make use of any of these API calls. Click here to register and once you are logged in, you will be able to create as many API Keys as you need.

Pricing

Some API calls have a fee, while others are free. To see more detailed information on the cost of API calls, please go to the pricing page.

Calling the API

Once you have an API key, you will be able to make calls to the API. Below are the details you will need:

API URL: https://www.teruza.com/api

AI

Our AI endpoint offers AI functions that can cover a wide range of use cases.

AI Query

Make any textual AI call

Method POST
Access Requires Authentication
Endpoint /api/v1/ai/query
Cost R 0.25 per call
Parameters
query
text (required)
The query to be sent to the AI.
Sample Response

No sample response available.

Document Analysis

Analyzes a document to determine its type (e.g. ID document, invoice, statement, etc.) and extracts relevant information into a structured JSON format for easy processing and integration.

Method POST
Access Requires Authentication
Endpoint /api/v1/ai/analyze_document
Cost R 0.45 per call
Parameters
document
file (required)
Base64 encoded string of the file to be analyzed.
Sample Response
NSFW Content Identifier

Analyzes an image or PDF to identify whether it is NSFW content, such as porn, hentai, violent images etc.

Method POST
Access Requires Authentication
Endpoint /api/v1/ai/nsfw_checker
Cost R 0.45 per call
Parameters
file
file (required)
Base64 encoded string of the file to be analyzed.
Sample Response
Receipt Analyzer

Analyzes a receipt to identify the billable items and other meta data on the receipt.

Method POST
Access Requires Authentication
Endpoint /api/v1/ai/receipt_analyzer
Cost R 0.45 per call
Parameters
file
file (required)
Base64 encoded string of the file to be analyzed.
Sample Response
Wine Label Analysis

Analyzes an image or PDF to identify the wine type, vintage, and country of origin etc.

Method POST
Access Requires Authentication
Endpoint /api/v1/ai/analyze_wine_label
Cost R 0.45 per call
Parameters
winelabel
file (required)
Base64 encoded string of the file to be analyzed.
Sample Response

AI Chat Bot

Integration points required to implement our AI chatbot.

Create Chatbot Instance

Creates a chatbot instance for a user.

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/create
Cost R 0.001 per call
Parameters
name
string (required)
The name of the chatbot.
description
string (optional)
A description that only admins will see.
image
file (optional)
Base64 encoded image to be used for the chatbot.
prompt
textarea (optional)
The prompt for the bot. I.e. The first message it will receive that should also define how it functions.
Sample Response
Create new Chatbot Session

Create a new chatbot session to which messages can be sent.

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/session/create
Cost R 0.001 per call
Parameters
botid
string (required)
The ID of the chatbot to update.
sessionid
string (optional)
A unique ID for the session. If not provided, a random one will be generated.
name
string (optional)
The name of the speaker.
email
email (optional)
The email of the speaker.
contact_number
string (optional)
The contact number of the speaker.
Sample Response
Embed a Chatbot on a Website

Speak to a chatbot session.

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/embed
Cost R 0.00 per call
Parameters
chatbotid
string (required)
The ID of the chatbot you want to embed.
Sample Response

No sample response available.

Get All Chatbot Instances

Returns all chatbot instances for a user.

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/getAll
Cost R 0.001 per call
Parameters

No parameters

Sample Response
Get Bot Conversation Message

Fetches data obtained through conversations with the bot (can be used to generate leads etc)

Method POST
Access Requires Authentication
Endpoint /api/v1/bot/getMessages
Cost R 0.02 per call
Parameters
chatBotID
string (required)
The ID of the Chatbot that you want to fetch data for.
page
integer (optional)
The page number you want to get. Default: 1.
limit
integer (optional)
Number of items per page you want to receive. Default: 20. Min: 1. Max: 100.
mustHaveData
integer (optional)
Only return messages that contain information in the "data" field. Default: 0.
Sample Response

No sample response available.

Get Chatbot Instance

Get full details of a chatbot instance.

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/get
Cost R 0.001 per call
Parameters
botid
string (required)
The ID of the chatbot to update.
Sample Response
Get Chatbot Leads

Get any lead data generated by the chatbot session.

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/leads/get
Cost R 0.00 per call
Parameters

No parameters

Sample Response

No sample response available.

Get Chatbot Session Instance

Get full details of a chatbot session including the chat history.

Method POST
Access Does not Require Authentication
Endpoint /api/v1/chatbot/session/get
Cost R 0.00 per call
Parameters
chatbotid
string (required)
The ID of the chatbot.
sessionid
string (required)
The Session ID.
Sample Response

No sample response available.

Get Chatbot embeddable CSS

Get chatbot embeddable CSS

Method POST
Access Does not Require Authentication
Endpoint /api/v1/chatbot/css/chatbot.css
Cost R 0.00 per call
Parameters

No parameters

Sample Response

No sample response available.

Get Chatbot embeddable JS

Get chatbot embeddable JS

Method POST
Access Does not Require Authentication
Endpoint /api/v1/chatbot/js/chatbot.js
Cost R 0.00 per call
Parameters

No parameters

Sample Response

No sample response available.

Speak to Chatbot Session

Speak to a chatbot session.

Method POST
Access Does not Require Authentication
Endpoint /api/v1/chatbot/speak
Cost R 0.02 per call
Parameters
sessionid
string (required)
The ID of the chatbot session to update.
chatbotid
string (optional)
The ID of the chatbot linked to the session. Reguired if the session does not exist yet.
message
textarea (required)
The message to send to the chatbot.
Sample Response
Update Chatbot Instance

Updates the details of a chatbot instance

Method POST
Access Requires Authentication
Endpoint /api/v1/chatbot/update
Cost R 0.001 per call
Parameters
botid
string (required)
The ID of the chatbot to update.
name
string (optional)
The name of the chatbot.
description
string (optional)
The description of the chatbot.
image
file (optional)
Base64 encoded image to be used for the chatbot.
personality
textarea (optional)
The personality of the chatbot.
overview
textarea (optional)
An overview of the business.
products
textarea (optional)
Detailed information on the products offered by the business.
services
textarea (optional)
Detailed information on the services offered by the business.
pricing
textarea (optional)
Detailed information on the pricing of the business.
support
textarea (optional)
Detailed information on the support offered by the business. I.e. How to get support and what type of support is available.
contact
textarea (optional)
Detailed contact information for the business. Include URLS, email, phone numbers, address, how to open support tickets etc.
boundaries
textarea (optional)
Detailed information on the boundaries of the chatbot. I.e. What is off limits and what is not.
qa
textarea (optional)
Sample questions and answers for the chatbot. (Highly recommennded)
Sample Response

Backend (Admin Only)

These are a variety of calls that will allow you to talk to this instance of Teruza directly. The calls in this category require admin access as they execute admin-level features.

Create Invoice

Creates Invoice for a specific User

Method POST
Access Requires Authentication of User with Admin access.
Endpoint /api/v1/invoices/create
Cost R 0.00 per call
Parameters
uid
integer (required)
User ID of the user for who the invoice must be created.
lineItem1Description
string (required)
Line item 1 description.
lineItem1Amount
string (required)
Line item 1 amount.
lineItem2Description
string (optional)
Line item 2 description.
lineItem2Amount
string (optional)
Line item 2 amount.
lineItem3Description
string (optional)
Line item 3 description.
lineItem3Amount
string (optional)
Line item 3 amount.
lineItem4Description
string (optional)
Line item 4 description.
lineItem4Amount
string (optional)
Line item 4 amount.
lineItem5Description
string (optional)
Line item 5 description.
lineItem5Amount
string (optional)
Line item 5 amount.
doNotSendInvoiceToClient
integer (optional)
If set to 1, the invoice will not be emailed to the client.
doNotSetAsPaid
integer (optional)
If set to 1, the invoice will have status = Unpaid.
Sample Response
Create User

Creates a new user

Method POST
Access Requires Authentication of User with Admin access.
Endpoint /api/v1/admin/user/create
Cost R 0.00 per call
Parameters
email
string (required)
Email of the user.
password
string (required)
Password to use when creating the user.
doNotSetAsVerified
integer (optional)
If set to 1, the user will not be set to verified and will have to verify their email address before logging in.
first_name
string (optional)
First name of the user.
last_name
string (optional)
Last name of the user.
id_nr
string (optional)
ID Number of the user.
phone_number
string (optional)
Phone number of the user.
company_name
string (optional)
Company name of the user.
company_nr
string (optional)
Company Nr of the user.
vat_nr
string (optional)
VAT nr of the user.
currency
string (optional)
Currency of the user.
country
string (optional)
Country Code of the user. e.g. ZA
address1
string (optional)
Address line 1
address2
string (optional)
Address line 2
city
string (optional)
City of the user
state
string (optional)
State / Province of the user
postal_code
string (optional)
Postal code of the user
Sample Response
Get User by Email

Fetches user details by email.

Method POST
Access Requires Authentication of User with Admin access.
Endpoint /api/v1/admin/user/getByEmail
Cost R 0.00 per call
Parameters
email
string (required)
Email of the user.
Sample Response
Get User by ID

Fetches user details by ID.

Method POST
Access Requires Authentication of User with Admin access.
Endpoint /api/v1/admin/user/getByID
Cost R 0.00 per call
Parameters
id
integer (required)
ID of the user.
Sample Response

Backend (Public)

These are a variety of calls that will allow you to talk to this instance of Teruza directly.

Enabled Social Login Providers

Returns a list of enabled social login providers.

Method GET
Access Does not Require Authentication
Endpoint /api/v1/social-login/enabled-providers
Cost R 0.00 per call
Parameters

No parameters

Sample Response
Facebook Social Login

Handles Facebook OAuth login for mobile app

Method POST
Access Does not Require Authentication
Endpoint /api/v1/social-login/facebook/app-callback
Cost R 0.00 per call
Parameters
accessToken
string (required)
The Facebook access token from the mobile app
Sample Response
Get Content

Grabs published content from the website

Method POST
Access Does not Require Authentication
Endpoint /api/v1/content/get
Cost R 0.00 per call
Parameters
contenttype
string (required)
The type of content to return.
page
integer (optional)
The page number you wish to access. (default: 1)
limit
integer (optional)
The number of items to return per page. (default: 10, maximum: 20)
sortby
string (optional)
The field by which to sort the results. (default: created_at, options: created_at, title, id, etc)
sortorder
string (optional)
The order in which to sort the results. (default: desc, options: asc, desc)
search
string (optional)
A search string to filter the results by.
filterField1
string (optional)
An additional field to filter the results by.
filterValue1
string (optional)
The value to filter the results by.
Sample Response

No sample response available.

Google Social Login

Handles Google OAuth login for mobile app

Method POST
Access Does not Require Authentication
Endpoint /api/v1/social-login/google/app-callback
Cost R 0.00 per call
Parameters
accessToken
string (required)
The Google access token from the mobile app
Sample Response
Login

Log in on this website. Returns a token for future user action execution.

Method POST
Access Does not Require Authentication
Endpoint /api/v1/user/login
Cost R 0.00 per call
Parameters
email
string (required)
The e-mail address of the new user.
password
string (required)
The password of the new user.
rememberme
string (optional)
If set to 1, tokens will only expire after 365 days or whatever number is configured in your Teruza instance settings.
Sample Response

No sample response available.

Logout

Log out the user by invalidating their mobile session token.

Method POST
Access Requires Authentication
Endpoint /api/v1/user/logout
Cost R 0.00 per call
Parameters
token
string (required)
The session token to invalidate.
Sample Response
Register

Register a new user on this site

Method POST
Access Does not Require Authentication
Endpoint /api/v1/user/register
Cost R 0.00 per call
Parameters
email
string (required)
The e-mail address of the new user.
password
string (required)
The password of the new user.
password_confirmation
string (required)
The password confirmation.
captcha_code
string (required)
The captcha code from the widget.
referral_code
string (optional)
A referral code.
Sample Response
Resend OTP

Resends a new OTP for email verification during registration, invalidating the previous one

Method POST
Access Does not Require Authentication
Endpoint /api/v1/mobile/resend-otp
Cost R 0.00 per call
Parameters
email
string (required)
The email address to resend the OTP to.
Sample Response
User Credit Balance

Gets the user's credit balance.

Method GET
Access Requires Authentication
Endpoint /api/v1/user/credit
Cost R 0.00 per call
Parameters

No parameters

Sample Response
Verify OTP

Verifies the OTP for email verification during registration

Method POST
Access Does not Require Authentication
Endpoint /api/v1/mobile/verify-otp
Cost R 0.00 per call
Parameters
email
string (required)
The email address to verify.
otp
string (required)
The OTP code sent to the email.
Sample Response

Banking

Our Banking module provides secure integration with banking services such as bank account verification.

Bank Account Verification

Allows third parties to perform real-time verifications on consumer and commercial bank accounts with the following banks: ABSA, FNB, Standard Bank, Nedbank, African Bank, Capitec, Investec, Sasfin Bank, and Discovery Bank.

Method POST
Access Requires Authentication
Endpoint /api/v1/banking/bank_account_verification
Cost R 17.95 per call
Parameters
bank_name
string (required)
One of the following: ABSA, ACCESS BANK, AFRICAN BANK, BIDVEST BANK, CAPITEC BANK, DISCOVERY BANK, FINBOND MUTAUL BANK, FNB, GRINROD BANK, INVESTEC BANK, MERCANTILE BANK, NEDBANK, SASFIN BANK, STANDARD BANK, TYME BANK, UBANK.
branch_code
string (required)
The bank account branch code of the account holder. Or alternatively the default branch code of the relevant bank: ABSA - 632005, ACCESS BANK - 410506, AFRICAN BANK - 430000, BIDVEST BANK - 462005, CAPITEC BANK - 470010, DISCOVERY BANK - 679000, FINBOND MUTAUL BANK - 591000, FNB - 250655, GRINROD BANK - 223626, INVESTEC BANK - 580105, MERCANTILE BANK - 450905, NEDBANK - 198765, SASFIN BANK - 683000, STANDARD BANK - 051001, TYME BANK - 678910, UBANK - 430000.
account_number
string (required)
The bank account number of the account holder.
account_type
integer (required)
Bank account type of account holder: 1 - current, 2 - savings, 3 - transmission, 4 - bond, 5 - credit card, 0 - not known.
idnumber
string (required)
ID Number of account holder or numeric part of Company registration number.
initials
string (required)
Initials of the account holder. If a Company a blank space must be used.
surname
string (required)
Surname of account holder or Company name.
Sample Response

No sample response available.

Companies

Our Companies endpoint lets you fetch and analyze business information from official or third-party sources.

CIPC (South Africa) Company Name Lookup

The API service provides an efficient and fast way to retrieve commercial company principle (Directorship in different companies) information from CIPC (Companies and Intellectual Properties Commission)

Method POST
Access Requires Authentication
Endpoint /api/v1/companies/cipc_company_name_lookup
Cost R 29.50 per call
Parameters
company_name
string (required)
The name of the South African company you are trying to find.
Sample Response
CIPC (South Africa) Registration Number Lookup

The API service provides an efficient and fast way to retrieve commercial company principle (Directorship in different companies) information from CIPC (Companies and Intellectual Properties Commission)

Method POST
Access Requires Authentication
Endpoint /api/v1/companies/cipc_company_reg_nr_lookup
Cost R 29.50 per call
Parameters
reg_nr
string (required)
The full registration number of the company you are looking up in the format: YYYY/NNNNNN/NN
Sample Response
South African Company VAT Number Lookup (WIP)

This API service enables a 3rd party to do a VAT Search either via a Company Name, Company Registration number or via a VAT number. Please note you must specify the vatSearchType which can be either of the following. 1-companyName, to search via Company Name. 2-companyRegNo to search via Company Registration number. 3-vatNumber to search with the company VAT number. both the companyNAme and companyRegNo will give multiple results with a primaryKey and a DBKey which must be used in the vat-dbkey-search to get the final results. the vatNumber search will give the result immediately.

Method POST
Access Requires Authentication
Endpoint /api/v1/companies/vat_lookup
Cost R 34.50 per call
Parameters
vat_search_type
string (required)
Type of VAT Search. Can be either 1 for Company Name, 2 for Company Registration Number or 3 for VAT Number.
company_name
string (optional)
if vat_search_type Type is companyName, this will be the Company Name
company_reg_no
string (optional)
if vat_search_type Type is companyRegNo, this will be the company registration number in the following format xxxx/xxxxxx/xx
vat_number
string (optional)
if vat_search_type Type is vatNumber, this will be the companies VAT Number
Sample Response

Currencies

Get foreign exchange currency rates and crypto asset prices.

All Currencies

Get Crypto and Forex Rates

Method GET
Access Requires Authentication
Endpoint /api/v1/currencies/all
Cost R 0.002 per call
Parameters

No parameters

Sample Response

No sample response available.

Crypto

Get Crypto Rates

Method GET
Access Requires Authentication
Endpoint /api/v1/currencies/crypto
Cost R 0.001 per call
Parameters

No parameters

Sample Response

No sample response available.

Forex

Get Forex Rates

Method GET
Access Requires Authentication
Endpoint /api/v1/currencies/forex
Cost R 0.001 per call
Parameters

No parameters

Sample Response

No sample response available.

Domain and Email Tools

A variety of domain API calls.

Email Test

Returns an email address to which you can send an email and then receive a response on the quality of the email sent.

Method POST
Access Requires Authentication
Endpoint /api/v1/email/test
Cost R 0.01 per call
Parameters

No parameters

Sample Response
Get Email Test Result

Returns the result of an email test

Method GET
Access Requires Authentication
Endpoint /api/v1/email/test/get
Cost R 0.01 per call
Parameters
code
string (required)
The code for the test you want to retrieve
Sample Response

No sample response available.

WHOIS Lookup

See owner details of a domain name.

Method POST
Access Requires Authentication
Endpoint /api/v1/domains/whois
Cost R 1.00 per call
Parameters
domainname
string (required)
The domain name to query. E.g. example.com
Sample Response

Geolocation

Our Geolocation tools help pinpoint user locations and enrich data with geographic context.

Geolocate

Map an IP Address to its physical location in the world as well as provide additional information on an IP (such as threatLevel, isCrawler and isProxy)

Method POST
Access Requires Authentication
Endpoint /api/v1/geolocation/geolocate
Cost R 0.05 per call
Parameters
ipaddress
string (required)
The IPv4 or IPv6 address that you want to look up.
Sample Response

ID Verification

Our ID Verification service validates identity documents and ensures compliance using real-time checks.

ID Lookup

Verifies a given South African ID number and its corresponding Consumer details.

Method POST
Access Requires Authentication
Endpoint /api/v1/id_verification/said_verification
Cost R 1.95 per call
Parameters
idnumber
string (required)
13 Digit South African ID Number
Sample Response
Real-time ID Verification with Photo

South Africa ID number verification against the live Home Affairs Databases with Photo ID.

Method POST
Access Requires Authentication
Endpoint /api/v1/id_verification/home_affairs_id_photo
Cost R 24.95 per call
Parameters
idnumber
string (required)
13 Digit South African ID Number
Sample Response

Images and PDF

A variety of image and PDF processing tools.

Face Compare

Compare two faces with each other and see how similar they are.

Method GET
Access Requires Authentication
Endpoint /api/v1/images/compareFaces
Cost R 0.40 per call
Parameters
image
file (required)
Base64 Encoded String of the Image to be Anbalyzed
face_token1
string (optional)
The id of the first face. (Highest precedence)
face_token2
string (optional)
The id of the second face
Sample Response

No sample response available.

Face Detection

Detects faces inside of an image.

Method GET
Access Requires Authentication
Endpoint /api/v1/images/detectFaces
Cost R 1.00 per call
Parameters
image
file (required)
Base64 Encoded String of the first Image to be Analyzed
externalid
string (optional)
An optional external ID that can be used to add a second reference to a lookup.
Sample Response

No sample response available.

Image to Text

Converts Images to Text

Method GET
Access Requires Authentication
Endpoint /api/v1/images/imageToText
Cost R 0.50 per call
Parameters
image
file (required)
Base64 Encoded String of the Image to be Converted to Text
Sample Response

No sample response available.

PDF to Image

Converts PDFs to Images

Method POST
Access Requires Authentication
Endpoint /api/v1/images/pdfToPng
Cost R 1.00 per call
Parameters
pdf
file (required)
Base64 Encoded String of the PDF to be Converted to Images
Sample Response

No sample response available.

PDF to Text

Converts PDFs to Text

Method GET
Access Requires Authentication
Endpoint /api/v1/images/pdfToText
Cost R 0.50 per call
Parameters
pdf
file (required)
Base64 Encoded String of the PDF to be Converted to Text
Sample Response

No sample response available.

KYC, AML & Other Lookups

Provides a comprehensive set of functions to verify individuals and companies, check against global sanctions and watchlists, and perform various other identification and compliance-related lookups

AML Search

Search sanctions and other watchlists.

Method GET
Access Requires Authentication
Endpoint /api/v1/kyc/aml/search
Cost R 2.50 per call
Parameters
type
string (optional)
Applicant Type (either "Person" or "Company"). Defaults to "Person"
name
string (required)
Full name of the applicant.
dob
date (required)
Date of Birth in format YYYY-MM-DD
Sample Response
Check Blurriness

Returns a score of how blurry an image is. < 1 = Not Blurry. > 1 = Blurry. > 4 = Very Blurry.

Method GET
Access Requires Authentication
Endpoint /api/v1/kyc/tools/blurriness
Cost R 0.50 per call
Parameters
image
string (required)
Base64 Encoded String of the image to checked
Sample Response

No sample response available.

Miscellaneous

Various other tools that do not fit into other categories.

Holidays

Get public holidays for a specific country.

Method POST
Access Requires Authentication
Endpoint /api/v1/misc/holidays
Cost R 0.05 per call
Parameters
countrycode
string (required)
ISO 3166-1 alpha-2 country code. E.g. ZA for South Africa.
year
string (required)
The year for which you want to get the holidays.
Sample Response

SMS

Our SMS gateway allows you to send text messages globally.

Add SMS Contact

Create an SMS contact and add it to a contact list.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/contactLists/[contactlistid]/add/[cellnr]
Cost R 0.00 per call
Parameters
contactlistid
string (required)
The id of the contact list you want to add a contact to.
cellnr
string (required)
The cell-number you would like to add. E.g: "+2772123456".
contactname
string (required)
The label assigned to this contact. E.g: "Mom".
Sample Response
Create SMS Contact List

Create an SMS contact list for sending SMS in bulk.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/contactLists/create/[contactlistname]
Cost R 0.00 per call
Parameters
contactlistname
string (required)
The name to use as a label for a grouping of contacts. E.g: "my-contacts".
Sample Response
Delete SMS Contact List

Delete a contact list.

Method POST
Access Requires Authentication
Endpoint /api/v1/sms/contactLists/delete/[contactlistid]
Cost R 0.00 per call
Parameters
contactlistid
string (required)
The id of the contact list you want returned.
Sample Response
Get SMS Contact Lists

Return all existing contact lists.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/contactLists/get
Cost R 0.00 per call
Parameters

No parameters

Sample Response
Get SMS Pricing

Get the cost to send to various countries in the world.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/pricing
Cost R 0.00 per call
Parameters

No parameters

Sample Response
Get a SMS Contact List

Return an individual contact list.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/contactLists/get/[contactlistid]
Cost R 0.00 per call
Parameters
contactlistid
string (required)
The id of the contact list you want returned.
page
string (optional)
The page that should be returned. Default: 1.
limit
string (optional)
How many results to return per page. Default: 20.
Sample Response
Remove SMS Contact

Delete an SMS contact from a contact list.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/contactLists/[contactlistid]/remove/[cellnr]
Cost R 0.00 per call
Parameters
contactlistid
string (required)
The id of the contact list you want returned.
cellnr
string (required)
The number you which wish to delete from a contact list. E.g: "+2772123456".
Sample Response
Send SMS

Send an SMS to any cellphone number in the world.

Method POST
Access Requires Authentication
Endpoint /api/v1/sms/send
Cost Varies
Parameters
cell_nr
string (required)
The number to which you want to send an sms. E.g: "+2772123456".
message
string (required)
The message you want to send.
send_at
string (optional)
The time at which you want to send the SMS. E.g: "2030-05-03 15:00:23". If no value specified, it will send the SMS immediately.
Sample Response
Send bulk SMS to Contact List

Send a bulk SMS to the cell numbers of a contact list.

Method GET
Access Requires Authentication
Endpoint /api/v1/sms/[contactlistid]?message=[message]
Cost R 0.00 per call
Parameters
contactlistid
string (required)
The id of the contact list you want returned.
message
textarea (required)
The message you would like to send to the contact list.
sendat
string (optional)
The time at which you want to send the SMS. E.g: "2030-05-03 15:00:23". If no value specified, it will send the SMS immediately.
Sample Response

No sample response available.

Scraper

Our Scraper extracts structured data from websites and documents for automated processing.

Screenshot

Take a screenshot of a website

Method POST
Access Requires Authentication
Endpoint /api/v1/screenshot
Cost R 0.10 per call
Parameters
url
string (required)
The URL that must be scraped.
width
integer (optional)
The width of the browser in which the site is rendered. Default: 1920.
height
integer (optional)
The height of the browser in which the site is rendered. Default: 1080.
Sample Response

No sample response available.

Web Scraper

Scrape a website URL

Method POST
Access Requires Authentication
Endpoint /api/v1/scrape
Cost R 0.005 per call
Parameters
url
string (required)
The URL that must be scraped.
useragent
string (optional)
The optional USER AGENT value you want to use when making requests.
Sample Response

Security

Various security related functions.

Ping

Endpoint to submit data returned from your server

Method GET
Access Requires Authentication
Endpoint /api/v1/security/ping
Cost R 0.00 per call
Parameters

No parameters

Sample Response

No sample response available.