BitelioBitelio
Referencia de API

Listar emails

El historial de envíos del proyecto, del más reciente al más antiguo, paginado por cursor. Por defecto solo muestra envíos reales; usa mode para ver los de prueba.

No hay búsqueda por asunto ni por contenido, a propósito: sobre millones de filas sería un escaneo, y decirlo es mejor que ofrecerlo y ser lento.

El cuerpo renderizado no viene en el listado — son cientos de kilobytes por página. Está en GET /v1/emails/{id}.

GET
/v1/emails

Authorization

ApiKeyAuth

AuthorizationBearer <token>

Autenticación mediante clave de API. Las claves secretas (sk_*) son obligatorias en todos los endpoints excepto /v1/track. Las claves públicas (pk_*) solo funcionan con el endpoint /v1/track para el seguimiento de eventos desde el cliente. El proyecto se deriva automáticamente de la clave.

In: header

Query Parameters

limit?integer

Page size.

Default25
Range1 <= value <= 100
cursor?string

El nextCursor de la página anterior. Opaco: devuélvelo tal cual.

mode?string

Qué envíos mostrar.

Default"live"
Value in"live" | "test" | "all"
status?string

Filtrar por estado de entrega.

Value in"PENDING" | "SENDING" | "HELD" | "SENT" | "DELIVERED" | "RECEIVED" | "OPENED" | "CLICKED" | "BOUNCED" | "COMPLAINED" | "FAILED"
to?string

Dirección del destinatario. Sin resultados si no es contacto del proyecto.

Formatemail
since?string

ISO 8601.

Formatdate-time
until?string

ISO 8601.

Formatdate-time

Response Body

application/json

curl -X GET "https://api.bitelio.com/v1/emails"
{
  "data": [
    {}
  ],
  "nextCursor": "string"
}
Empty
Empty