Listar campañas
GET/v1/campaigns
Scope necesario: read o full. Una clave full incluye send y read.
status; paginación por cursor. 60 consultas por minuto y clave (compartidas con /v1/stats).
Parámetros
| Campo | Descripción |
|---|---|
cursorstring · query | nextCursor de la página anterior con los mismos filtros. |
limitnumber · query | |
statusstring · query |
Respuestas
200Campo Descripción data[]object[] · obligatoriodata[].idstring · obligatoriodata[].objectstring · obligatoriovalores: campaign data[].namestring · obligatoriodata[].statusstring · obligatoriovalores: draft | scheduled | sending | sent | cancelled | paused | failed data[].subjectstring | null · obligatoriodata[].fromNamestring | null · obligatoriodata[].fromEmailstring | null · obligatoriodata[].scheduledAtstring | null · obligatoriodata[].sendStartedAtstring | null · obligatoriodata[].sendFinishedAtstring | null · obligatoriodata[].createdAtstring · obligatoriodata[].updatedAtstring · obligatoriodata[].deferReasonstring | null · obligatorioPor qué el envío está aplazado, si lo está. valores: daily_limit | quotadata[].trackingAvailableboolean · obligatorioHay seguimiento de aperturas y clics en esta campaña. data[].metricsobject · obligatoriodata[].metrics.recipientsnumber · obligatorioDestinatarios de la campaña (congelados al confirmar). data[].metrics.sentnumber · obligatorioEntregados al proveedor. data[].metrics.deliverednumber · obligatorioCon evidencia de entrega. data[].metrics.bouncednumber · obligatoriodata[].metrics.complainednumber · obligatoriodata[].metrics.openednumber · obligatorioAperturas únicas. data[].metrics.openedTotalnumber · obligatorioAperturas totales. data[].metrics.clickednumber · obligatorioClics únicos. data[].metrics.clickedTotalnumber · obligatorioClics totales. data[].metrics.unsubscribednumber · obligatoriodata[].metrics.ratesobject · obligatorionextCursorstring | null · obligatorio
Ejemplo
curl "https://api.vemudo.com/v1/campaigns?status=sent" -H "Authorization: Bearer $VEMUDO_API_KEY"