---
title: "Check phone health"
method: GET
path: "/whatsapp/phone_numbers/{phone_number_id}/health"
tags: ["Phone Numbers"]
---

# Check phone health

`GET /whatsapp/phone_numbers/{phone_number_id}/health`

## Request

- Base URL: `https://api.kapso.ai/platform/v1`
- URL: `https://api.kapso.ai/platform/v1/whatsapp/phone_numbers/{phone_number_id}/health`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/kapso/apis/kapso-platform-api/docs/whatsapp/phone_numbers/:phone_number_id/health/get.ts> (a function with typed inputs; its response is checked against the schema)

Live health check via Meta APIs and Kapso services.

## Response `200`

Health status

- WhatsappPhoneNumberHealthResponse
  - `status` 'healthy' | 'degraded' | 'unhealthy' | 'error', required
  - `timestamp` string, date-time, required
  - `error` string, nullable
  - `checks` object, nullable: Individual check results. Typical checks: - phone_number_access: Meta API connectivity - messaging_health: Send/receive capability (AVAILABLE/LIMITED/BLOCKED) - webhook_subscription: WABA app subscription status - webhook_verified: Webhook verification status - token_validity: Access token validity (coexistence only)

## Other responses

- `401`: Missing or invalid API key
- `404`: Resource not found

---

[API](https://skmtc.dev/kapso/apis/kapso-platform-api.md) - [All operations](https://skmtc.dev/kapso/apis/kapso-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kapso/apis/kapso-platform-api/revisions/18ff5548a33f?raw)