Skip to content

The SureVoIP RESTful API API

by surevoip.co.uk

HTTP BasicHTTPSPhone
Open documentation ↗

Overview

# Introduction Welcome to the SureVoIP RESTful hypermedia API (sometimes known as a VoIP REST API, Telecom REST API, SIP API, Hypermedia API or just VoIP API.) The SureVoIP API is a way for you to automate your interaction with the SureVoIP platforms. With the API, you can create your own scripts, applications or mashups which can: * List calls * create customers * search numbers * provision numbers * send SMS texts * create outbound calls * schedule announcements * schedule call hangups with an announcement * subscribe to events/alerts * track calls * retrieve invoices * grab your SIP details * check your IP address * be 100% self-sufficient * and much more!

The SureVoIP RESTful API is a phone API from surevoip.co.uk. Requests are authenticated with HTTP Basic auth. It is served over HTTPS. Its OpenAPI description documents 28 endpoints.

At a glance

Authentication
HTTP Basic
HTTPS
Yes
CORS
Unknown
Category
Phone
Base URL
https://api.surevoip.co.uk
Version
9dcb0dc8
Endpoints
28
Spec updated
2021-07-11

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.surevoip.co.uk/" \
  -H "Accept: application/json" \
  -H "Authorization: Basic BASE64_USER_PASSWORD"
JavaScript
const response = await fetch("https://api.surevoip.co.uk/", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Basic BASE64_USER_PASSWORD",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://api.surevoip.co.uk/",
    headers={
    "Accept": "application/json",
    "Authorization": "Basic BASE64_USER_PASSWORD",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/List global resources
GET/announcementsList global announcements
POST/announcementsAdd a new announcement audio file
GET/areacodesList areacodes
GET/billingList global billing detail
GET/callsValidate a phone number by calling it once
POST/callsCreate phone calls with or without announcements and scheduled hangups
GET/chargesList charges
POST/chargesCreate charges for invoices
GET/contactsList contacts
GET/customersList all customers or find your own account
GET/customers/{account}Represents a customer
GET/customers/{account}/announcementsList of announcement audio files
GET/customers/{account}/announcements/{announcement_id}Represents an announcement audio file
DELETE/customers/{account}/announcements/{announcement_id}Delete an announcement audio file
GET/faxesList global ongoing faxes
GET/hostedList Hosted VoIP domains
GET/ip-addressReturn the IP address from where your API request originated
GET/mobileList mobile accounts
GET/numbersList available SureVoIP Ofcom number allocations for purchase
GET/numbers/areacodesSearch available numbers by areacode
GET/partnersList SureVoIP Partner accounts
GET/portingList ported numbers
GET/service-statusList all Service Status messages
GET/sipList all SIP accounts
GET/smsList SMS
POST/support/echoReturn your POSTed data for testing
GET/topupsList all account credit topups

Questions

Does the The SureVoIP RESTful API API need an API key?

Yes. The The SureVoIP RESTful API API uses HTTP Basic authentication; the documentation explains how to get credentials.

Does the The SureVoIP RESTful API API support HTTPS?

Yes, the The SureVoIP RESTful API API is served over HTTPS.

How many endpoints does the The SureVoIP RESTful API API have?

Its OpenAPI description lists 28 endpoints in version 9dcb0dc8. All of them are shown on this page.

What are alternatives to the The SureVoIP RESTful API API?

Other Phone APIs include Twilio - Accounts, ETSI GS MEC 010-2 - Part 2: Application lifecycle, rules and requirements management, Twilio - Api, Mobility API, Telnyx API.

Compare alternatives →

Listed from APIs.guru (CC0).