WhatsApp · Schema

PhoneNumber

PhoneNumber from WhatsApp API

Properties

Name Type Description
id string
display_phone_number string
verified_name string
quality_rating string
code_verification_status string
is_official_business_account boolean
name_status string
platform_type string
throughput object
account_mode string
messaging_limit_tier string
View JSON Schema on GitHub

JSON Schema

whatsapp-business-management-api-phone-number-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/json-schema/whatsapp-business-management-api-phone-number-schema.json",
  "title": "PhoneNumber",
  "description": "PhoneNumber from WhatsApp API",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "example": "wamid.abc123"
    },
    "display_phone_number": {
      "type": "string",
      "example": "+15551234567"
    },
    "verified_name": {
      "type": "string",
      "example": "Example Business"
    },
    "quality_rating": {
      "type": "string",
      "enum": [
        "GREEN",
        "YELLOW",
        "RED",
        "UNKNOWN"
      ],
      "example": "GREEN"
    },
    "code_verification_status": {
      "type": "string",
      "enum": [
        "VERIFIED",
        "NOT_VERIFIED",
        "EXPIRED"
      ],
      "example": "VERIFIED"
    },
    "is_official_business_account": {
      "type": "boolean",
      "example": true
    },
    "name_status": {
      "type": "string",
      "example": "Example Business"
    },
    "platform_type": {
      "type": "string",
      "enum": [
        "CLOUD_API",
        "ON_PREMISE",
        "NOT_APPLICABLE"
      ],
      "example": "CLOUD_API"
    },
    "throughput": {
      "type": "object",
      "properties": {
        "level": {
          "type": "string",
          "enum": [
            "STANDARD",
            "HIGH"
          ]
        }
      }
    },
    "account_mode": {
      "type": "string",
      "enum": [
        "LIVE",
        "SANDBOX"
      ],
      "example": "LIVE"
    },
    "messaging_limit_tier": {
      "type": "string",
      "enum": [
        "TIER_1K",
        "TIER_10K",
        "TIER_100K",
        "TIER_UNLIMITED"
      ],
      "example": "TIER_1K"
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/whatsapp-business-management-api-phone-number"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.