WhatsApp · JSON Structure

Whatsapp Business Management Api Phone Number Structure

PhoneNumber from WhatsApp API

Type: object Properties: 11

PhoneNumber is a JSON Structure definition published by WhatsApp, describing 11 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id display_phone_number verified_name quality_rating code_verification_status is_official_business_account name_status platform_type throughput account_mode messaging_limit_tier

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/json-structure/whatsapp-business-management-api-phone-number-structure.json",
  "name": "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 Structure 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 json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure 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 Structure
curl "https://apis.io/api/v1/json-structures/whatsapp-business-management-api-phone-number-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?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.