Consumo de un Número Telefónico Consulta de métricas, consumos mensuales y llamadas de un número específico.

Obtener Consumo de un Número Específico (GET)

Este endpoint permite consultar de manera individual el consumo y registro de llamadas de un número de teléfono asignado a la organización, con posibilidad de filtrar por año y mes.

Método HTTP

GET

Endpoint URL

'https://app.x-ianet.com/api/xianet/number-consumption/{phone_number}'

Donde {phone_number} es el número en formato internacional E.164 (ej: +34822272470).

Encabezados Requeridos (Headers)

Header Tipo Descripción
ApiUser string Usuario de API de la organización.
ApiKey string Clave API de la organización.
Accept string application/json

Parámetros de Ruta (URI Parameters)

Parámetro Tipo Descripción
phone_number string Número telefónico en formato E.164 con prefijo internacional (ej. +34822272470).

Parámetros de Consulta Opcionales (Query Parameters)

Parámetro Tipo Descripción
year integer Filtra los consumos por un año específico (ej: 2026).
month integer Filtra los consumos por un mes específico (del 1 al 12).
details integer / boolean Por defecto 1. Enviar details=0 para omitir el desglose detallado de cada llamada y recibir una respuesta más rápida y ligera.

Ejemplo de Solicitud

GET https://app.x-ianet.com/api/xianet/number-consumption/+34822272470?year=2026&month=9

Respuesta Exitosa (Código 200 OK)


{
  "id": 41,
  "phone_number": "+34822272470",
  "phone_type": "3CX",
  "country_code": "ES",
  "status_phone": 1,
  "xianet_id": "fc5b8631-aaa6-45f3-80cc-fbf27da106b5",
  "assistant_id": "",
  "total_calls": 201,
  "total_call_cost": 14.9835,
  "total_messages": 0,
  "total_message_cost": 0.0,
  "total_cost": 14.9835,
  "consumptions": [
    {
      "id": 180,
      "year": 2026,
      "month": 9,
      "call_count": 201,
      "call_cost": 14.9835,
      "message_count": 0,
      "message_cost": 0.0,
      "total_cost": 14.9835,
      "deducted_amount": 14.9835,
      "is_deducted": true,
      "details": [
        {
          "id": 2277,
          "type": "call",
          "sid": "CAe146c0296851ab4ab8fda5954230394a",
          "from": "+34822272470",
          "to": "sip:+34822272949@dominio.3cx.es",
          "direction": "trunking-originating",
          "duration": 91,
          "duration_formatted": "00:01:31",
          "cost": 0.015,
          "status": "completed",
          "date": "2026-09-22 09:28:50"
        }
      ]
    }
  ]
}

Respuestas de Error

Código 404 Not Found: Si el número de teléfono no existe o no está asignado a la organización autenticada.


{
  "message": "Phone number not found or not assigned to this organization"
}

Código 401 Unauthorized: Si las credenciales enviadas son inválidas.


{
  "message": "Client not found or unauthenticated"
}