BitelioBitelio
Referencia de API

Listar SMS

El historial de SMS del proyecto, del más reciente al más antiguo, paginado por cursor — la misma forma que GET /v1/emails, para que un cliente pagine los dos igual.

Cada fila trae segments y encoding, y esa es la razón de ser del endpoint. El SMS se factura por segmento: un mensaje GSM-7 se parte cada 160 caracteres; uno Unicode, cada 70. Un solo carácter acentuado en una plantilla pasa el mensaje entero a Unicode y puede duplicar su coste. Este es el único sitio donde ese número se puede leer después del envío.

El cuerpo no viene en el listado — está en GET /v1/sms/{id}.

GET
/v1/sms

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

Tamaño de página.

Default25
Range1 <= value <= 100
cursor?string

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

status?string

Filtrar por estado de entrega.

Value in"PENDING" | "QUEUED" | "SENT" | "DELIVERED" | "UNDELIVERED" | "FAILED"
to?string

Destino en E.164, coincidencia exacta.

since?string

ISO 8601.

Formatdate-time
until?string

ISO 8601.

Formatdate-time

Response Body

application/json

curl -X GET "https://api.bitelio.com/v1/sms"
{
  "data": [
    {
      "id": "string",
      "to": "string",
      "from": "string",
      "country": "string",
      "encoding": "GSM7",
      "segments": 0,
      "status": "PENDING",
      "error": "string"
    }
  ],
  "nextCursor": "string"
}
Empty
Empty