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"
    }
  }
}