Skip to content
WhatsMarketingDeveloper Hub

WhatsApp lines

Your WhatsApp numbers and their health at Meta: quality, messaging tier, whether they are paused and why, and whether they still need registering. Use it to warn your team before a red line stops sending. Needs numbers:read.

List lines

GET/numbers

qualityRating is GREEN, YELLOW or RED (null if Meta has not rated it yet). messagingLimitTier is the cap of distinct people per 24 hours (TIER_250 to TIER_UNLIMITED). status: PAUSED_BY_META comes with pausedReason and pausedAt. registration is REGISTERED, PENDING, PIN_REQUIRED or ERROR, or null if nothing is known to be missing. Health is refreshed with Meta at most once an hour (healthCheckedAt).

Scopes: numbers:read

curl
curl "https://micuenta.whatsmarketing.es/api/v1/numbers" \
  -H "Authorization: Bearer $WM_API_KEY"
Node.js
const res = await fetch('https://micuenta.whatsmarketing.es/api/v1/numbers', {
  headers: {
    Authorization: `Bearer ${process.env.WM_API_KEY}`,
  },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://micuenta.whatsmarketing.es/api/v1/numbers",
    headers={"Authorization": f"Bearer {os.environ['WM_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()
PHP
<?php
$ch = curl_init('https://micuenta.whatsmarketing.es/api/v1/numbers');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('WM_API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
Response 200
{
  "data": [
    {
      "id": "5b2a9c1e-7d3f-4e8a-9b0c-1d2e3f4a5b6c",
      "number": "+34600111222",
      "displayName": "Ventas",
      "verifiedName": "Tu Empresa SL",
      "status": "ACTIVE",
      "pausedReason": null,
      "pausedAt": null,
      "qualityRating": "GREEN",
      "messagingLimitTier": "TIER_1K",
      "registration": "REGISTERED",
      "isTestNumber": false,
      "templatesApproved": 12,
      "uniqueRecipientsLast24h": 87,
      "healthCheckedAt": "2026-11-11T09:40:00.000Z"
    }
  ]
}