The Simple Telecom API

Manage your services, pull call detail records and control call routing programmatically. A simple, Bearer-token REST API at api.simpletelecom.com.au/v1 — included free with every Simple Telecom service.

Get an API Token

What can you do with the API?

List Your Services

GET /api/services — inventory active services, map service IDs to numbers, and sync them into your own systems.

Call Detail Records

GET /api/cdrs — pull rated call records for billing reconciliation, usage analytics and cost attribution.

Read Call Routing

GET /api/services/{id}/routing — see exactly how each number is forwarded and whether recording is on.

Manage Forwarding

POST / PUT / DELETE forwarding — add, update or remove forwarding numbers and build sequential overflow flows.

Call Recording

PUT /api/services/{id}/routing/recording — enable or disable call recording on any service.

Simple Auth & Errors

Bearer tokens from your console, predictable JSON errors and clear rate-limit headers.

Ready to automate your telecoms?

The Simple Telecom API at a glance

The Simple Telecom API lets you integrate your phone numbers with your own software. Built on a straightforward, versioned REST interface, it's protected by Bearer-token authentication and returns predictable JSON — including a consistent error format — so you can build reliable integrations without fighting the platform.

Start here

Get a token — log in to the customer console, open Settings → API Access and click Generate API Token. Send it as Authorization: Bearer st_... on every request.
Find your services — call GET /api/services to list your active services and their IDs.
Drill into the parts you need — see the capabilities below.

Base URL: https://api.simpletelecom.com.au/v1

The API is included free with all Simple Telecom services — there are no additional API charges. The data you read and write (services, CDRs, routing) is exactly what powers your numbers.

API capabilities

| Endpoint | Method | What it does | |---|---|---| | /api/services | GET | List all active services on your account | | /api/cdrs | GET | Pull paginated call detail records for a service | | /api/services/{service_id}/routing | GET | View a service's full routing configuration | | /api/services/{service_id}/routing/forwarding | POST | Add a forwarding number | | /api/services/{service_id}/routing/forwarding | PUT | Update a forwarding number | | /api/services/{service_id}/routing/forwarding | DELETE | Remove a forwarding number | | /api/services/{service_id}/routing/recording | PUT | Enable or disable call recording |

Explore the API docs

Each topic below drills into a specific part of the Simple Telecom API — with parameters, responses and working code snippets.

Authentication & API tokens — get, secure and revoke your Bearer tokens.
Your services — list and inventory your active services with GET /api/services.
Call detail records — pull usage and billing data with GET /api/cdrs.
Call routing — read how each number is forwarded with GET /api/services/{id}/routing.
Manage forwarding — add, update and remove forwarding numbers.
Call recording — enable or disable recording on a service.
Error handling — the error model, error codes, and how to handle rate limits.
Quickstart — get your first request working in minutes.
Code examples — a copy-paste reference library in curl, PHP and JavaScript.
Use cases — real end-to-end automation scenarios.

Do you have an API feature in mind?

The API is under active development. If there's an integration you'd like to build that we don't cover yet, email info@simpletelecom.com.au — we're keen to hear what you need.