Consultar la cuenta y estadísticas
Saca por API de solo lectura todo lo de tu cuenta de Vemudo: resumen y uso del plan, listado de emails con filtros, eventos, estadísticas por día, dominios, contactos y campañas.
Por Equipo Vemudo · Actualizado el
read (o full). Las consultas son de solo lectura y siempre de tu propia organización: ningún endpoint acepta un id de organización.
Reglas comunes
Aislamiento. Un id de otra organización, de otro entorno o mal formado devuelve 404 not_found, igual que uno inexistente.Entornos. Los recursos de envío (emails, eventos, estadísticas y webhooks) son solo los del entorno de la clave: una clave testno ve emailslive, ni al revés. Los recursos de la organización (cuenta, dominios, contactos, listas, segmentos, campañas, plantillas y bajas) los ve cualquier clave con permiso de lectura,testolive.Sin secretos. Nunca se devuelven hashes de claves, secretos de webhook (solo enmascarados), cuerpos de email ni datos personales de los miembros del panel. Formato. JSON en camelCase, fechas en ISO 8601 UTC y estados en minúsculas. Sin caché. Las respuestas llevan Cache-Control: no-store.Errores. application/problem+jsoncon uncodeestable. Ver Errores y límites.
Paginación
{ "data": [], "nextCursor": "..." }limit va de 1 a 100 (25 por defecto). Dominios, listas y segmentos no se paginan (son pocos) y devuelven siempre nextCursor: null. Mientras nextCursor no sea null, pásalo como cursor en la siguiente petición. El cursor es opaco: no lo construyas ni lo interpretes.
curl "https://api.vemudo.com/v1/emails?limit=100&cursor=$NEXT" \
-H "Authorization: Bearer $VEMUDO_API_KEY"Resumen de la cuenta
curl https://api.vemudo.com/v1/account -H "Authorization: Bearer $VEMUDO_API_KEY"organization: id, nombre, estado y fecha de alta.planysubscription: tu plan (código, nombre, emails incluidos) y el estado y periodo de la suscripción, onullsi no tienes.period: el periodo de facturación actual.usage: emails enviados, incluidos, restantes, reservados (programados), tope (cap) y política de excedente (overagePolicy). Son los mismos cálculos que el panel, incluido el tope mensual propio si tu organización lo tiene.limits: límites de envío por segundo, por día y por mes.counts: número de dominios (y verificados), contactos, listas, segmentos, campañas, plantillas y webhooks.apiKey: la clave que has usado (id, nombre, prefijo, entorno y scopes).
Emails enviados
curl "https://api.vemudo.com/v1/emails?status=bounced,complained&since=2026-11-01T00:00:00Z" \
-H "Authorization: Bearer $VEMUDO_API_KEY"GET /v1/emails lista los emails del entorno de la clave, del más reciente al más antiguo. Filtros opcionales, combinables:
status | delivered,bounced). |
to | @; si no, empieza por (mín. 3). |
from | |
subject | |
tag | nombre:valor, o solo nombre. |
campaignId, templateId, apiKeyId | |
origin | api, test_send o campaign. |
since, until | until con solo fecha = todo el día). |
GET /v1/emails/{id}, sin los eventos. El cuerpo del email no se expone por la API.
read o full; una clave send ve el email pero no este listado):
curl https://api.vemudo.com/v1/emails/$ID/events -H "Authorization: Bearer $VEMUDO_API_KEY"Estadísticas
curl "https://api.vemudo.com/v1/stats?since=2026-10-05&until=2026-11-04" \
-H "Authorization: Bearer $VEMUDO_API_KEY"days: una entrada por día conrequested,sent,delivered,bounced,complained,failed,suppressed,cancelled,opened,clickedyunsubscribed. Los días sin actividad salen con ceros.totals: la suma del periodo.rates: tasas en % con 2 decimales (nullsi no hay base). Entrega y rebote se calculan sobresent; queja, apertura y clic sobredelivered.
since y until son fechas YYYY-MM-DD. Por defecto son los últimos 30 días y el máximo son 92. Puedes acotar por campaignId o por domain (el dominio del remitente).
Dominios, contactos, listas y segmentos
curl https://api.vemudo.com/v1/domains -H "Authorization: Bearer $VEMUDO_API_KEY"
curl https://api.vemudo.com/v1/contacts -H "Authorization: Bearer $VEMUDO_API_KEY"
curl https://api.vemudo.com/v1/lists -H "Authorization: Bearer $VEMUDO_API_KEY"
curl https://api.vemudo.com/v1/segments -H "Authorization: Bearer $VEMUDO_API_KEY"q, status, listId y tag. Más información en Dominios y DNS y Contactos, listas y segmentos.
Campañas
GET /v1/campaigns y GET /v1/campaigns/{id} devuelven las campañas con sus métricas (destinatarios, enviados, entregados, rebotes, quejas, aperturas, clics, bajas y tasas) como el informe del panel. El detalle incluye los enlaces más pulsados.
Plantillas, bajas y webhooks
GET /v1/templates, GET /v1/suppressions y GET /v1/webhooks también se pueden leer con read. Ver Plantillas, Bajas y supresiones y Eventos y webhooks.
Límites de estas consultas
GET /v1/stats, GET /v1/account, segmentos y campañas (calculan recuentos en vivo) admiten además 60 peticiones por minuto por clave, y las consultas pesadas tienen un tiempo máximo de 3 segundos: si tienes mucho volumen, acota el rango de fechas.
Ejemplo: tasa de rebote de la semana
const res = await fetch('https://api.vemudo.com/v1/stats?since=2026-10-29&until=2026-11-04', {
headers: { Authorization: `Bearer ${process.env.VEMUDO_API_KEY}` },
});
const { totals, rates } = await res.json();
console.log(`Enviados: ${totals.sent}, rebote: ${rates.bounce}`);