Get phone number details
Retrieve detailed information about a specific phone number.
By default returns basic information. Use fields parameter to request additional data like throughput limits, account mode, certificate status, etc.
Proxy endpoint: Proxies directly to Meta Graph API.
Authorizations
Project API key for authentication. This is the recommended authentication method.
Get your API key from the Kapso dashboard under Project Settings > API Keys.
Path Parameters
WhatsApp Business Phone Number ID
Query Parameters
Comma-separated list of fields to retrieve.
Available fields: id, verified_name, display_phone_number, quality_rating, code_verification_status, is_official_business_account, name_status, new_name_status, platform_type, throughput, account_mode, certificate, messaging_limit_tier
Example: fields=id,verified_name,display_phone_number,quality_rating,throughput,messaging_limit_tier
Response
Phone number details retrieved successfully
Phone number ID
Verified business name associated with the phone number
Phone number in international format
Quality rating based on message delivery.
- GREEN: High quality
- YELLOW: Medium quality
- RED: Low quality
- NA: Not yet determined
- UNKNOWN: Status unknown
GREEN, YELLOW, RED, NA, UNKNOWN Verification status of the phone number
Whether this is an official business account
Status of the business name
Status of pending name change
Platform type (CLOUD_API, etc.)
Messaging throughput limits
Account mode (SANDBOX for testing, LIVE for production)
SANDBOX, LIVE Certificate status
Current messaging limit tier (TIER_50, TIER_250, TIER_1K, TIER_10K, TIER_100K, TIER_UNLIMITED)