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

WhatsApp Phone Numbers API

List and manage phone numbers on a WABA

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

This API exposes 2 JSON Schema definitions.

Tagged areas include Phone Numbers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an AsyncAPI specification, an API reference, a getting-started guide, and 2 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 21.0.

Requests are made against a single base URL, https://graph.facebook.com/v21.0.

2 operations 2 paths 3 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
21.0
Base URL
https://graph.facebook.com/v21.0
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

WhatsApp Phone Numbers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — System User Token with whatsappbusinessmanagement permission

Paths & Operations 2

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

Phone Numbers 2

List and manage phone numbers on a WABA

GET
/{waba-id}/phone_numbers
WhatsApp List Phone Numbers
listPhoneNumbers 5 params → 200
GET
/{phone-number-id}
WhatsApp Get Phone Number Info
getPhoneNumber 2 params → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are PhoneNumber (11 properties), PhoneNumberInfo (8 properties), CursorPaging (3 properties). Each schema is shown below with its type and property counts.

PhoneNumberInfo
object
8 properties
PhoneNumber
object
11 properties
CursorPaging
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs WhatsApp publishes across the network.

WhatsApp Flows API
WhatsApp On-Premises API
WhatsApp Analytics API
WhatsApp Assets API
WhatsApp Assigned Users API
WhatsApp Business Accounts API
WhatsApp Business Profile API
WhatsApp Lifecycle API
WhatsApp Media API
WhatsApp Message Templates API
WhatsApp Messages API
WhatsApp Product Catalogs API