Telefonie

Telefonie Owned Numbers API

Manage phone numbers in your account

Documentation GitHub OpenAPI

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/telefonie-owned-numbers-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.0.3
info:
  title: Telefonie Number Management Available Numbers Owned Numbers API
  description: Search, purchase, configure, and manage phone numbers. Supports local, national, toll-free, and mobile numbers across multiple countries with full lifecycle management.
  version: v1
  contact:
    name: Telefonie Support
    url: https://www.telefonie.com/support
  termsOfService: https://www.telefonie.com/terms
servers:
- url: https://api.telefonie.com/v1/numbers
  description: Telefonie Number Management API
security:
- ApiKeyAuth: []
tags:
- name: Owned Numbers
  description: Manage phone numbers in your account
paths:
  /owned:
    get:
      operationId: listOwnedNumbers
      summary: List Owned Numbers
      description: List all phone numbers in your account.
      tags:
      - Owned Numbers
      parameters:
      - name: type
        in: query
        schema:
          type: string
          enum:
          - local
          - national
          - toll-free
          - mobile
        description: Filter by number type
      - name: page
        in: query
        schema:
          type: integer
        description: Page number
      - name: page_size
        in: query
        schema:
          type: integer
          maximum: 100
      responses:
        '200':
          description: List of owned numbers
          content:
            application/json:
              schema:
                type: object
                properties:
                  numbers:
                    type: array
                    items:
                      $ref: '#/components/schemas/OwnedNumber'
                  total:
                    type: integer
    post:
      operationId: purchaseNumber
      summary: Purchase Number
      description: Purchase a phone number and add it to your account.
      tags:
      - Owned Numbers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - phone_number
              properties:
                phone_number:
                  type: string
                  description: Phone number to purchase in E.164 format
                voice_url:
                  type: string
                  description: Webhook URL for incoming voice calls
                sms_url:
                  type: string
                  description: Webhook URL for incoming SMS messages
                friendly_name:
                  type: string
                  description: Human-readable label for the number
      responses:
        '201':
          description: Number purchased
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OwnedNumber'
  /owned/{phone_number}:
    get:
      operationId: getOwnedNumber
      summary: Get Owned Number
      description: Get configuration details for a specific owned phone number.
      tags:
      - Owned Numbers
      parameters:
      - name: phone_number
        in: path
        required: true
        schema:
          type: string
        description: Phone number in E.164 format (URL-encoded)
      responses:
        '200':
          description: Phone number details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OwnedNumber'
    post:
      operationId: updateOwnedNumber
      summary: Update Owned Number
      description: Update the configuration (webhooks, friendly name) for an owned number.
      tags:
      - Owned Numbers
      parameters:
      - name: phone_number
        in: path
        required: true
        schema:
          type: string
        description: Phone number in E.164 format
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                voice_url:
                  type: string
                  description: Webhook URL for incoming voice calls
                sms_url:
                  type: string
                  description: Webhook URL for incoming SMS messages
                friendly_name:
                  type: string
                  description: Updated label for the number
      responses:
        '200':
          description: Number updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OwnedNumber'
    delete:
      operationId: releaseNumber
      summary: Release Number
      description: Release a phone number from your account. This action cannot be undone.
      tags:
      - Owned Numbers
      parameters:
      - name: phone_number
        in: path
        required: true
        schema:
          type: string
        description: Phone number in E.164 format
      responses:
        '204':
          description: Number released
components:
  schemas:
    OwnedNumber:
      type: object
      properties:
        phone_number:
          type: string
          description: Phone number in E.164 format
        friendly_name:
          type: string
          description: Human-readable label
        type:
          type: string
          enum:
          - local
          - national
          - toll-free
          - mobile
          description: Number type
        country_code:
          type: string
          description: ISO country code
        capabilities:
          type: object
          properties:
            voice:
              type: boolean
            sms:
              type: boolean
            mms:
              type: boolean
        voice_url:
          type: string
          description: Webhook URL for incoming calls
        sms_url:
          type: string
          description: Webhook URL for incoming SMS
        date_created:
          type: string
          format: date-time
          description: When the number was purchased
        monthly_rate:
          type: string
          description: Monthly rental rate
      required:
      - phone_number
      - type
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key