List phone numbers
List all WhatsApp phone numbers purchased by the authenticated user. By default, released numbers are excluded.
API key authentication - use your Late API key as a Bearer token
In: header
Query Parameters
Filter by status (by default excludes released numbers)
"provisioning" | "active" | "suspended" | "releasing" | "released"Filter by profile
Response Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/whatsapp/phone-numbers"{
"numbers": [
{
"_id": "string",
"phoneNumber": "string",
"country": "string",
"status": "pending_payment",
"profileId": {},
"provisionedAt": "2019-08-24T14:15:22Z",
"metaPreverifiedId": "string",
"metaVerificationStatus": "string",
"createdAt": "2019-08-24T14:15:22Z"
}
]
}{
"error": "Unauthorized"
}Get phone number GET
Retrieve the current status of a purchased phone number. Used to poll for Meta pre-verification completion after purchase.
Purchase phone number POST
Initiate purchasing a WhatsApp phone number. Payment-first flow: the user does not pick a specific number. The system either creates a Stripe Checkout Session (first number) or increments the existing subscription quantity and provisions inline (subsequent numbers). Requires a paid plan. The maximum number of phone numbers is determined by the user's plan.