How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wazo Phone Numbers API

The phone-numbers API from Wazo — 4 operation(s) for phone-numbers.

Wazo Phone Numbers API is one of 113 APIs that Wazo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Phone Numbers. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, a changelog, authentication docs, and an AsyncAPI specification.

This API exposes 8 operations across 4 paths, and defines 6 schemas. It is described by OpenAPI 3.2.0, at version 1.1.

Requests are made against a single base URL, /1.1.

8 operations 4 paths 6 schemas 1 DELETE3 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1
Base URL
https://{wazo_stack}/api/auth/0.1
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

Wazo Phone Numbers API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Auth-Token (wazo_auth_token). By default, every request must be authenticated.

Paths & Operations 8

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

phone-numbers 8
GET
/phone-numbers
List phone numbers
list_phone_numbers 9 params → 200
POST
/phone-numbers
Add a new phone number
create_phone_number 1 param body → 201400
POST
/phone-numbers/ranges
Add a range of phone numbers
create_phone_numbers_range 1 param body → 201400
GET
/phone-numbers/{phone_number_uuid}
Get phone number
get_phone_number 2 params → 200404
PUT
/phone-numbers/{phone_number_uuid}
Update Phone Number
update_phone_numbers 2 params body → 204400404
DELETE
/phone-numbers/{phone_number_uuid}
Delete Phone Number
delete_phone_number 2 params → 204404
GET
/phone-numbers/main
Get main phone number
get_phone_number_main 1 param → 200404
PUT
/phone-numbers/main
set the 'main' phone number for the tenant
set_phone_number_main 1 param body → 204400

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are PhoneNumber (6 properties), Link (2 properties), PhoneNumberRangeResponse (2 properties), PhoneNumberRange (2 properties). Each schema is shown below with its type and property counts.

PhoneNumberItems
object
1 property
PhoneNumberRange
object
a request to register a range of phone number resources
2 properties 2 required
PhoneNumber
object
a phone number resource, usable for outgoing caller id or incall routing
6 properties 2 required
PhoneNumberRangeResponse
object
2 properties
Link
object
a pointer to a linked resource related in some way to the current resource
2 properties
Error
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wazo-phone-numbers-api-openapi.yml Raw ↑

Other APIs Wazo publishes across the network.

Wazo Phone Provisioning API (wazo-provd)
Wazo Websocket Event Stream (wazo-websocketd)
Wazo Aastra API
Wazo Access Features API
Wazo Action API
Wazo Adhoc Conferences API
Wazo Admin API
Wazo Agent Statistics API
Wazo Agents API
Wazo Applications API
Wazo Asterisk API
Wazo Backends API
Where this information came from

This is an independent, third-party profile of Wazo Phone Numbers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.