---
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`

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.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)
