Listado de Números de Teléfono Consulta de números asignados con consumos mensuales y detalle de llamadas.

Este endpoint permite recuperar la lista completa de todos los números de teléfono asignados a la organización del cliente, incluyendo los totales históricos de llamadas/mensajes, los consumos desglosados por mes y el registro detallado de cada llamada.

Método HTTP

GET

Endpoint URL

'https://app.x-ianet.com/api/xianet/listnumbers'

Ruta alternativa: https://app.x-ianet.com/api/v1/listnumbers

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 Consulta (Query Parameters)

Parámetro	Tipo	Por Defecto	Descripción
details	integer / boolean	1	Indica si se incluye el arreglo details con cada llamada/mensaje individual del mes. Enviar details=0 para obtener una respuesta ligera únicamente con los totales y resúmenes mensuales.

Respuesta Exitosa (Código 200 OK)

Retorna un arreglo JSON donde cada elemento representa una línea telefónica con sus métricas acumuladas y sus consumos ordenados cronológicamente (del mes más reciente al más antiguo):

[
  {
    "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": 2248,
    "total_call_cost": 315.0102,
    "total_messages": 0,
    "total_message_cost": 0.0,
    "total_cost": 315.0102,
    "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"
          }
        ]
      }
    ]
  }
]
            

Descripción de Campos

Nivel Línea Telefónica (Objeto Raíz)

• id: (int) ID interno del número en la base de datos.
• phone_number: (string) Número telefónico en formato internacional E.164.
• phone_type: (string) Tipo de proveedor o servicio (ej: 3CX, voice, whatsapp).
• country_code: (string) Código ISO del país (ej: ES).
• status_phone: (int) Estado de la línea (1 = Activo, 0 = Inactivo).
• xianet_id: (string) ID único del número asignado en el motor de voz / IA.
• total_calls: (int) Total histórico acumulado de llamadas.
• total_call_cost: (float) Costo total calculado de llamadas en USD ($).
• total_messages: (int) Total acumulado de mensajes SMS/WhatsApp.
• total_message_cost: (float) Costo total calculado de mensajes en USD ($).
• total_cost: (float) Costo total consolidado de la línea telefónica.
• consumptions: (array) Lista de consumos mensuales ordenados del más reciente al más antiguo.

Nivel Desglose Mensual (consumptions[])

• id: (int) ID del registro mensual de consumo.
• year: (int) Año correspondiente (ej: 2026).
• month: (int) Mes correspondiente (1 al 12).
• call_count: (int) Cantidad de llamadas realizadas/recibidas en el mes.
• call_cost: (float) Costo final calculado de llamadas del mes ($).
• message_count: (int) Cantidad de mensajes procesados en el mes.
• message_cost: (float) Costo final calculado de mensajes del mes ($).
• total_cost: (float) Costo total calculado del mes ($).
• deducted_amount: (float) Monto descontado del saldo/crédito de la cuenta ($).
• is_deducted: (bool) true si el consumo mensual ya fue descontado del saldo.
• details: (array) Listado de eventos individuales de llamadas o mensajes del mes.

Nivel Detalle Individual (details[])

• id: (int) ID del registro detallado.
• type: (string) Tipo de comunicación: call o message.
• sid: (string) Identificador único del evento en el proveedor telefónico.
• from: (string) Número o URI SIP de origen.
• to: (string) Número o URI SIP de destino.
• direction: (string) Dirección de la comunicación (inbound, outbound, trunking-originating, etc.).
• duration: (int) Duración de la llamada en segundos.
• duration_formatted: (string) Duración en formato legible HH:MM:SS.
• cost: (float) Costo calculado final de esta llamada o mensaje en USD ($).
• status: (string) Estado final (completed, busy, no-answer, sent, etc.).
• date: (string) Fecha y hora en formato YYYY-MM-DD HH:MM:SS.