Ir al contenido
WhatsMarketingDeveloper Hub

Líneas de WhatsApp

Tus números de WhatsApp y su salud en Meta: calidad, nivel de mensajería, si están pausados y por qué, y si falta registrarlos. Úsalo para avisar a tu equipo antes de que una línea en rojo deje de enviar. Necesita numbers:read.

Listar líneas

GET/numbers

qualityRating es GREEN, YELLOW o RED (null si Meta aún no la calificó). messagingLimitTier es el tope de personas distintas por 24 h (TIER_250 a TIER_UNLIMITED). status: PAUSED_BY_META trae pausedReason y pausedAt. registration es REGISTERED, PENDING, PIN_REQUIRED o ERROR, o null si no consta que falte. La salud se refresca con Meta como mucho una vez por hora (healthCheckedAt).

Permisos: 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);
Respuesta 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"
    }
  ]
}