Teliax Toll Free API

Toll-free number management via Somos TFN Registry

Operations 36

GET /v1/tollfree/templates List templates #
PUT /v1/tollfree/templates Update template #
POST /v1/tollfree/templates Create template #
PUT /v1/tollfree/templates/{tmplName}/unlock Unlock template #
PUT /v1/tollfree/templates/{tmplName}/lock Lock template #
PUT /v1/tollfree/query Query TFN status #
POST /v1/tollfree/templates/{tmplName}/disconnect Disconnect template #
GET /v1/tollfree/templates/drafts List drafts #
POST /v1/tollfree/templates/drafts Save draft #
POST /v1/tollfree/templates/drafts/{draftId}/push Push draft to Somos #
POST /v1/tollfree/templates/copy Copy template #
POST /v1/tollfree/search-spare Search spare numbers #
POST /v1/tollfree/search-and-reserve Search & reserve #
POST /v1/tollfree/reserve Reserve specific numbers #
POST /v1/tollfree/ptr-operations/{id}/retry Retry a failed/timed-out PTR operation #
POST /v1/tollfree/disconnect/{num} Disconnect TFN #
POST /v1/tollfree/change-resporg Change RespOrg #
POST /v1/tollfree/activate Activate TFNs #
GET /v1/tollfree/templates/{tmplName} Retrieve full template #
DELETE /v1/tollfree/templates/{tmplName} Delete template #
GET /v1/tollfree/templates/{tmplName}/history Template history #
GET /v1/tollfree/templates/{tmplName}/history/{effDtTm}/{activityTimestamp} Template history version #
GET /v1/tollfree/templates/drafts/{draftId} Get draft #
DELETE /v1/tollfree/templates/drafts/{draftId} Delete draft #
GET /v1/tollfree/status Check Somos availability #
GET /v1/tollfree/reserved-numbers List reserved numbers #
GET /v1/tollfree/ptr-operations List PTR operations for a TFN #
GET /v1/tollfree/ptr-operations/{id} Get a single PTR operation #
GET /v1/tollfree/pointer-record/{num} Query pointer record #
GET /v1/tollfree/inventory Get inventory list #
GET /v1/tollfree/inventory/summary Get inventory summary #
GET /v1/tollfree/history/{tfn} Get TFN history #
GET /v1/tollfree/entities/{entityId}/respOrgs Get RespOrgs for entity #
GET /v1/tollfree/entities/{entityId}/respOrgs/active Get active RespOrgs #
GET /v1/tollfree/customer-config Get toll-free config #
DELETE /v1/tollfree/reserve/{tfn} Release reservation #

Documentation

Specifications

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-identity-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-query-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-cpr-dump-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-dno-lookup-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-complex-query-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-tandem-query-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-port-project-detail-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-port-project-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-port-project-detail-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-soa-query-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-toll-free-ptr-operation-dto-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-auto-activation-settings-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-github-com-ringer-warp-api-gateway-internal-models-trunk-group-with-ips-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-github-com-ringer-warp-api-gateway-internal-models-assignment-with-usages-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-internal-handlers-trunk-update-result-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-github-com-ringer-warp-api-gateway-internal-models-trunk-group-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-github-com-ringer-warp-api-gateway-internal-models-assignment-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/json-schema/teliax-internal-handlers-bulk-assign-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/teliax:teliax-toll-free-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

teliax-toll-free-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Teliax Toll Free API
  version: v1
  contact:
    name: Ringer API Support
    url: https://ringer.tel
    email: api-support@ringer.tel
  description: 'Operations tagged Toll-Free across 2 of this provider''s published API definitions: teliax-tniq-openapi.json, teliax-tniq-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.tniq.ringer.tel
  description: Production
- url: https://tniq-api.ringer.tel
  description: Production (legacy alias)
- url: https://staging-api.ringer.tel
  description: Staging
tags:


# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/teliax/refs/heads/main/openapi/teliax-toll-free-api-openapi.yml