---
title: "List numbers for selection"
method: GET
path: "/v1/connect/whatsapp/select-phone-number"
tags: ["Connect"]
---

# List numbers for selection

`GET /v1/connect/whatsapp/select-phone-number`

Fetch the WhatsApp phone numbers available across the user's WhatsApp Business Accounts (WABAs) after a headless OAuth flow.

WhatsApp OAuth grants access at the WABA level. When a connected WABA has 2 or more phone numbers, you must call this endpoint to list them and then `POST /v1/connect/whatsapp/select-phone-number` to bind one to the Zernio profile. Single-phone WABAs auto-complete during the OAuth callback and never reach this endpoint.

Use the `profileId` and `tempToken` returned in the headless redirect (`step=select_phone_number`).

Alternative: if you already know `wabaId` and `phoneNumberId` (e.g. from Meta Business Suite), use `connectWhatsAppCredentials` instead, which skips this two-step flow.

## Query parameters

- `profileId` string, required
- `tempToken` string, required

## Headers

- `X-Connect-Token` string

## Response `200`

Phone numbers fetched successfully

- object
  - `phoneNumbers` object[]
    - `id` string — Phone Number ID (Meta)
    - `display_phone_number` string — E.164-formatted display number
    - `verified_name` string — Meta-verified business name
    - `quality_rating` string — GREEN, YELLOW, RED, or UNKNOWN
    - `name_status` string — APPROVED, PENDING_REVIEW, DECLINED, or NONE
    - `messaging_limit_tier` string — TIER_250, TIER_1K, TIER_10K, TIER_100K, or TIER_UNLIMITED
    - `wabaId` string — WhatsApp Business Account ID (Zernio enrichment)
    - `wabaName` string — WABA display name (Zernio enrichment)

## Other responses

- `400` — Missing profileId or tempToken
- `401` — Unauthorized
- `500` — Failed to fetch phone numbers (Meta API error, expired token, or insufficient permissions)

---

[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/revisions/51932b099b2f/schema)