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

# Get number status

`GET /v1/whatsapp/number-info`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/whatsapp/number-info`
- Auth: HTTP bearer

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`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `404`: WhatsApp account not found

## Changes

- **2026-10-06** `f8c8f34fb41a`: 1 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `401`
- **2026-10-02** `d556591af3f6`: 7 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `docUrl` to the response with the `401` status
  - added the optional property `param` to the response with the `401` status
  - …3 more

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/whatsapp/number-info/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/4e74db179e73?raw)