WhatsApp · Schema

WhatsAppAccountNumber

WhatsApp Account Number details and configuration

MessagingAnalyticsWhatsAppBusiness MessagingMeta

Properties

Name	Type	Description
id	string	Unique identifier for the WhatsApp Account Number
display_phone_number	string	Phone number in international format for display purposes
verified_name	string	Business name verified for this phone number
status	object
quality_rating	object
country_code	string	ISO 3166-1 alpha-2 country code
country_dial_code	string	Country dialing code
code_verification_status	object
name_status	object
messaging_limit_tier	string	Current messaging limit tier for the account number
account_mode	object
certificate	string	Business certificate information for the account number
is_official_business_account	boolean	Whether this is an official business account

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/whatsapp/json-schema/whatsapp-whats-app-account-number-schema.json",
  "title": "WhatsAppAccountNumber",
  "description": "WhatsApp Account Number details and configuration",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/whatsapp-business-messaging-api-openapi.yml#/components/schemas/WhatsAppAccountNumber",
  "type": "object",
  "required": [
    "id",
    "display_phone_number",
    "status"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the WhatsApp Account Number"
    },
    "display_phone_number": {
      "type": "string",
      "description": "Phone number in international format for display purposes"
    },
    "verified_name": {
      "type": "string",
      "description": "Business name verified for this phone number"
    },
    "status": {
      "$ref": "#/$defs/WhatsAppAccountNumberStatus"
    },
    "quality_rating": {
      "$ref": "#/$defs/WhatsAppPhoneNumberQualityRating"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "country_dial_code": {
      "type": "string",
      "description": "Country dialing code"
    },
    "code_verification_status": {
      "$ref": "#/$defs/WhatsAppCodeVerificationStatus"
    },
    "name_status": {
      "$ref": "#/$defs/WhatsAppDisplayNameStatus"
    },
    "messaging_limit_tier": {
      "type": "string",
      "description": "Current messaging limit tier for the account number",
      "enum": [
        "TIER_50",
        "TIER_250",
        "TIER_1K",
        "TIER_10K",
        "TIER_100K",
        "TIER_UNLIMITED"
      ]
    },
    "account_mode": {
      "$ref": "#/$defs/WhatsAppBusinessSandboxEligibility"
    },
    "certificate": {
      "type": "string",
      "description": "Business certificate information for the account number"
    },
    "is_official_business_account": {
      "type": "boolean",
      "description": "Whether this is an official business account"
    }
  },
  "$defs": {
    "WhatsAppAccountNumberStatus": {
      "type": "string",
      "description": "Current status of the WhatsApp Account Number",
      "enum": [
        "CONNECTED",
        "DISCONNECTED",
        "UNVERIFIED",
        "PENDING",
        "FLAGGED",
        "RESTRICTED"
      ]
    },
    "WhatsAppBusinessSandboxEligibility": {
      "type": "string",
      "description": "Account mode indicating sandbox or live environment",
      "enum": [
        "LIVE",
        "SANDBOX"
      ]
    },
    "WhatsAppCodeVerificationStatus": {
      "type": "string",
      "description": "Two-step verification status for the phone number",
      "enum": [
        "VERIFIED",
        "UNVERIFIED"
      ]
    },
    "WhatsAppDisplayNameStatus": {
      "type": "string",
      "description": "Status of the display name associated with the phone number",
      "enum": [
        "APPROVED",
        "AVAILABLE_WITHOUT_REVIEW",
        "DECLINED",
        "EXPIRED",
        "PENDING_REVIEW",
        "NONE"
      ]
    },
    "WhatsAppPhoneNumberQualityRating": {
      "type": "string",
      "description": "Quality rating based on message delivery and user feedback",
      "enum": [
        "GREEN",
        "YELLOW",
        "RED",
        "NA"
      ]
    }
  }
}

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-whats-app-account-number"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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