Listar emails
GET/v1/emails
Scope necesario: read o full. Una clave full incluye send y read.
test nunca ve emails live y al revés), del más reciente al más antiguo. Requiere scope read (o full). Cada elemento es el mismo objeto que GET /v1/emails/{id} sin la línea de eventos (/v1/emails/{id}/events). Filtros combinables; paginación por cursor (nextCursor) con los mismos filtros.
Parámetros
| Campo | Descripción |
|---|---|
cursorstring · query | nextCursor de la página anterior con los mismos filtros. |
limitnumber · query | |
statusstring · query | |
tostring · query | @, dirección exacta; si no, prefijo (mínimo 3 caracteres). |
fromstring · query | |
subjectstring · query | |
tagstring · query | nombre:valor, o nombre para cualquier valor. |
campaignIdstring · query | |
templateIdstring · query | |
apiKeyIdstring · query | |
originstring · query | |
sincestring · query | |
untilstring · query |
Respuestas
200Campo Descripción data[]object[] · obligatoriodata[].idstring · obligatoriodata[].objectstring · obligatoriovalores: email data[].statusstring · obligatoriovalores: accepted | queued | rendered | submitted | delivered | rejected | suppressed | bounced | complained | cancelled | failed data[].environmentstring · obligatoriovalores: test | live data[].categorystring · obligatoriovalores: critical | transactional data[].fromstring · obligatorioej.: Tienda <[email protected]> data[].tostring · obligatorioej.: [email protected] data[].subjectstring · obligatoriodata[].tagsobject · obligatoriodata[].scheduledAtstring | null · obligatoriodata[].createdAtstring · obligatoriodata[].submittedAtstring | null · obligatoriodata[].errorCodestring | null · obligatoriodata[].templateobject | null · obligatoriodata[].template.idstring · obligatoriodata[].template.aliasstring · obligatoriodata[].template.versionnumber · obligatorionextCursorstring | null · obligatorioCursor de la página siguiente ( nullen la última).
Ejemplo
curl "https://api.vemudo.com/v1/emails?status=bounced,failed&since=2026-10-01&limit=50" -H "Authorization: Bearer $VEMUDO_API_KEY"