---
title: "Get number info"
method: GET
path: "/api/profiles/{profile_id}/whatsapp/number_info"
tags: ["WhatsApp"]
---

# Get number info

`GET /api/profiles/{profile_id}/whatsapp/number_info`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{profile_id}/whatsapp/number_info`
- Auth: HTTP bearer

Reads a phone number’s live state from Meta together with the account’s, and refreshes the placement metadata.

## Query parameters

- `profile_group_id` string
- `phone_number_id` string, required

## Response `200`

Live number and account state.

- WhatsAppNumberInfoResponse
  - `phone` object: Live number state from Meta: display_phone_number, verified_name, name_status, new_name_status, quality_rating, messaging_limit_tier, throughput, status, platform_type, is_official_business_account.
  - `waba` object, nullable: Account state: name, account_review_status, business_verification_status, timezone_id, ownership_type. Null when the account-level read fails.
  - `placement_id` string

## Other responses

- `400`: Missing required parameters.
- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.
- `422`: Validation failed.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)
