Generar Reporte de Envíos

Genera un reporte de envíos SMS con filtros por fecha, referencia, o número. Rate-limited a 3 solicitudes simultáneas.

post/reports/generate

Authorizations

apikeystringheaderrequired

Body

application/json

date_fromstring

Fecha de inicio (YYYY-MM-DD)

date_tostring

Fecha de fin (YYYY-MM-DD)

referencestring

Filtrar por referencia de mensaje

numberstring

Filtrar por número de destinatario

statusstring

Filtrar por estatus de entrega (0-12)

Response

200Reporte generado exitosamente

successboolean

messagestring

Mensaje de estado

statusinteger

codestring

Código de respuesta

reportarray<object>

▸ Show array item attributes▾ Hide array item attributes

namestring

Nombre de la campaña

created_datestring

Fecha y hora de creación

referencestring

ID de referencia del mensaje

numberstring

Número de teléfono del destinatario

messagestring

Contenido del SMS

sent_datestring

Fecha y hora de envío

statusstring

Estado de entrega (0-12 mapeado)

operatorstring

Operador móvil

typestring

400Error de validación.

successboolean

Siempre `false` para respuestas de error

messagestring

Descripción del error en español

statusinteger

Código HTTP de la respuesta

codestring

Código de error estructurado (`{dominio}_{número}`). Identifica de forma única la causa del error para manejo programático.

401No autorizado — API Key no provista, inválida o expirada

successboolean

Siempre `false`

messagestring

Descripción del error de autenticación en español

statusinteger

Código HTTP

codestring

Código de error de autenticación (`auth_01`, `auth_05`, `auth_06`, `auth_07`, `auth_99`)

403Prohibido — La dirección IP no está autorizada para acceder (IP whitelist)

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error: `auth_04` (IP no autorizada en whitelist)

429Demasiadas peticiones — Límite de rate limit excedido (100 mensajes/segundo producción, 100/día sandbox)

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error de rate limit

500Error interno del servidor

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error interno

request_idstring· uuid

Identificador único de la petición. Inclúyelo al contactar a soporte.