Lea su consumo por día, número o proyecto

Antes de empezar

Una clave de prueba ficticia: tq_test_EXEMPLE.
Un período: dos fechas en formato AAAA-MM-DD.
La agrupación deseada: day, number, project, country o service.

Versión de demostración. El diseño puede cambiar. Los datos devueltos son simulados y no hay ninguna API de producción abierta.

Consultar el consumo

Llame a GET /usage con from y to, los límites del período.
Añada group_by para elegir cómo leer los datos: día, número, proyecto, país o servicio.
Lea el campo provisional. Vale true cuando aún pueden llegar eventos con retraso: el total no es entonces definitivo.

Ejemplo ficticio: lectura por día durante un mes de demostración.

curl "https://api.example.test/v1/usage?from=2026-10-01&to=2026-10-31&group_by=day" \
  -H "Authorization: Bearer tq_test_EXEMPLE"

Ejemplo de respuesta

Cada línea da una clave de agrupación (key), un servicio, un sentido, una unidad y una cantidad. Las unidades cambian según el servicio: duración para la voz, segmentos para los SMS. No las sume entre sí.

Ejemplo ficticio de respuesta. Valores inventados, sin importes.

{
  "data": [
    { "key": "2026-10-01", "service": "voice", "direction": "outbound", "unit": "second", "quantity": 5400 },
    { "key": "2026-10-01", "service": "sms", "direction": "outbound", "unit": "segment", "quantity": 120 }
  ],
  "provisional": false
}

Puntos de atención

Una llamada puede generar varias líneas de consumo, por ejemplo cuando tiene varios tramos técnicos. Una línea no siempre es una llamada.
Un SMS largo cuenta como varios segmentos: la cantidad de SMS es un número de segmentos, no de mensajes.
Separe el sentido entrante y el saliente: las unidades y las reglas contractuales pueden diferir.
La duración facturable (billable_seconds en el registro de llamadas) no es el tiempo de timbre ni necesariamente la duración de la conversación.
La respuesta contiene cantidades. Los importes, cuando existen, dependen de su contrato y se muestran en la consola.

Errores frecuentes

Síntoma	Causa probable	Qué hacer
400 invalid_request	Fecha mal formada, from posterior a to, group_by desconocido.	Use AAAA-MM-DD y uno de los valores indicados.
El total cambia entre dos lecturas	provisional vale true: todavía llegan eventos.	Vuelva a leer más tarde para un período cerrado.
Diferencia con el registro de llamadas	Unidades distintas (segundos de consumo y duración de conversación).	Compare en la misma unidad y el mismo sentido.

Lo que esta guía no hace

No calcula ningún coste: no hay ninguna tarifa pública, todo es bajo presupuesto.
No sustituye la conciliación con los documentos contractuales y la facturación.
No afirma que existan volúmenes reales: el ejemplo es ficticio.

Describir sus volúmenes en una solicitud de presupuesto API de voz