Consultar un número adquirido

Consulte el registro de un número adquirido y su configuración almacenada. Esta operación devuelve un objeto en lugar del array del endpoint inventory.

Solicitud

Utilice credenciales de API del lado del servidor a través de HTTPS. Los ejemplos leen las credenciales de variables de entorno; no contienen credenciales válidas. Compruebe status.code en el cuerpo JSON, además del estado HTTP. Estos controladores heredados no siempre establecen un estado de error HTTP cuando se produce un error de aplicación.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

El segmento de ruta obligatorio es el número de teléfono internacional almacenado, no su UUID ni una extensión de centralita PBX. Este controlador no utiliza parámetros de consulta ni cuerpo de solicitud.

Respuesta

Esta estructura de respuesta es ilustrativa; no contiene datos de una cuenta ni constituye una cotización de precios actual.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Campos del número devueltos
Campo	Significado
`number, uuid, description, isocode`	El número de teléfono almacenado, su identificador opaco, la descripción y el código de país.
`config`	Campos almacenados de destinos de voz, desvío externo, destino de SMS y reenvío de SMS. Este endpoint no los modifica.
`features`	Indicadores almacenados de capacidades de voz, SMS y MMS. No se garantiza que los indicadores heredados almacenados sean valores booleanos JSON.
`status.capacity`	Valores de canales asignados y utilizados, configuración de desbordamiento y cargo por exceso almacenado. Son metadatos almacenados, no una nueva cotización de capacidad ni una prueba de llamada en tiempo real.
`status.origination`	Metadatos de originación almacenados. Trate los identificadores como opacos; no derive la lógica de la aplicación de los nombres internos.
`status.service_active, force_codec, force_dtmf`	Campos almacenados de activación y configuración de medios. Un indicador por sí solo no demuestra que la entrega entrante se haya realizado correctamente.
`billing`	Valores almacenados de CNAM, desbordamiento, renovación, persistencia y creación. Consultarlos no cambia la renovación ni otros ajustes de facturación.
`price`	Precios almacenados de alta, mensuales y por minuto, y cantidades de minutos incluidos. El controlador no proporciona un campo de moneda ni una cotización actualizada. No deduzca la moneda a partir de los valores de ejemplo ni los utilice como una cotización de compra actual.

En comparación con inventory, este endpoint también devuelve needs_registration, vrating, country_id, area_id, provider_id y price.perminute_charges. Son valores heredados almacenados, no una respuesta independiente de aprobación de identidad. Los identificadores de referencia deben tratarse como opacos; no construya URL de descubrimiento ni deduzca correspondencias con proveedores a partir de ellos sin la respuesta de descubrimiento correspondiente.

Ningún número coincidente

Si no se encuentra ningún registro coincidente que no esté anulado para la cuenta autenticada, el cuerpo JSON contiene status.code 404 y un mensaje que contiene number not found. No se base en el sufijo que indica la línea del código fuente. Compruebe el número almacenado y inventory antes de volver a intentarlo.

Utilizar el resultado

Esta operación consulta datos guardados. No compra un número, no aprueba documentos de identidad, no cambia un destino ni garantiza la entrega de una llamada, un fax o un mensaje. Pruebe cada servicio habilitado por separado al configurar un número.