---
title: "Get number status"
method: GET
path: "/v1/whatsapp/number-info"
tags: ["WhatsApp Phone Numbers"]
---

# Get number status

`GET /v1/whatsapp/number-info`

Live snapshot of a connected number straight from Meta: the phone-number node
(display number, display name + approval, quality rating, messaging-limit tier,
throughput, official-business badge, connection status, health_status) and its
owning WhatsApp Business Account (name, business verification, timezone,
health_status). Fetched live because Meta updates quality/tier/name/health over
time; the call also refreshes the cached values shown on the connection card.

## Query parameters

- `accountId` string, required

## Response `200`

Number + WABA status

- object
  - `phone` object
    - `display_phone_number` string
    - `verified_name` string
    - `name_status` string — APPROVED, AVAILABLE_WITHOUT_REVIEW, PENDING_REVIEW, DECLINED, EXPIRED, NONE
    - `quality_rating` string — GREEN, YELLOW, RED, UNKNOWN
    - `messaging_limit_tier` string — e.g. TIER_250, TIER_1K, TIER_UNLIMITED
    - `throughput` object
      - `level` string — STANDARD or HIGH
    - `status` string — e.g. CONNECTED
    - `is_official_business_account` boolean
    - `platform_type` string — e.g. CLOUD_API
    - `health_status` object — Meta's can_send_message health object (messaging + calling signals)
  - `waba` object, nullable
    - `name` string
    - `business_verification_status` string — verified, not_verified, pending, ...
    - `timezone_id` string — Meta integer timezone-enum id
    - `health_status` object

## Other responses

- `400` — Phone number ID not found on account
- `401` — Unauthorized
- `404` — WhatsApp account not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)