Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Telefon Owned Numbers API

Manage numbers in your account

Telefon Owned Numbers API is one of 7 APIs that Telefon publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Owned Numbers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a getting-started guide, pricing, and rate-limit docs.

This API exposes 4 operations across 2 paths, and defines 1 schema. It is described by OpenAPI 3.0.3, at version v1.

Requests are made against a single base URL, https://api.telefon.com/v1/numbers.

4 operations 2 paths 1 schemas 1 DELETE2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v1
Base URL
https://api.telefon.com/v1/voice
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Telefon Owned Numbers API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 DELETE, 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Owned Numbers 4

Manage numbers in your account

GET
/owned
List Owned Numbers
listOwnedNumbers 3 params → 200
POST
/owned
Purchase Number
purchaseNumber body → 201
GET
/owned/{phone_number}
Get Owned Number
getOwnedNumber 1 param → 200
DELETE
/owned/{phone_number}
Release Number
releaseNumber 1 param → 204

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is OwnedNumber (9 properties). Each schema is shown below with its type and property counts.

OwnedNumber
object
9 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

telefon-owned-numbers-api-openapi.yml Raw ↑

Other APIs Telefon publishes across the network.

Telefon Available Numbers API
Telefon Calls API
Telefon Conferences API
Telefon Messages API
Telefon Recordings API
Telefon Transcriptions API