Developers

REST API for the platform you already operate

Authenticated access to the resources you manage in the portal, documented per endpoint.

Authentication

Requests are authenticated with either HTTP Basic (username and password) or a bearer token, scoped to your account and tenant. Unauthenticated requests receive a 401 response.

Example request

curl -u "${USERNAME}:${PASSWORD}" \
  "https://api.switcht.io/rest/numbers?per-page=50&page=1"

Pagination and rate limits

List endpoints accept page and per-page query parameters (up to 500 per page) and return pagination totals in response headers:

X-Total-Count: 1842
X-Page-Count: 37
X-Current-Page: 1
X-Per-Page: 50
X-Rate-Limit-Limit: 100
X-Rate-Limit-Remaining: 97
X-Rate-Limit-Reset: 42
Example

Live calls

Returns the calls currently active for your account. Exact fields depend on your role and permissions — supplier and client identifiers are only included if your account can view them.

GET /rest/live-calls

[
  {
    "Caller ID": "441...",
    "Destination Number": "441...",
    "Service": "Inbound DDI",
    "Billing Group": "Default",
    "Duration": "00:02:41",
    "Start": "2026-09-16 10:14:02"
  }
]
Resources

Available API resources

Number inventory, allocation, and range checks

Live calls, where configured

SMS records

Billing groups

Test voice and test SMS numbers

Missed-traffic tracking

Voice and SMS access rules

Resource availability depends on your tenant configuration and role permissions.