---
url: https://docs.consultaunica.mx/services/ifetel.md
description: >-
  Consulta un número de 10 dígitos en el registro oficial de numeración
  telefónica: si es fijo o móvil, la compañía, la lada y la ciudad de registro.
---

# 📞 Servicio de consulta de teléfono

* Método: `POST`
* URL de Consumo: `https://api.consultaunica.mx/v3/phones`
* Compra de paquetes: <https://consultaunica.mx/paquetes>

> 🧪 **¿Todavía sin créditos?** Prueba este servicio en `POST /v3/mock/phones`, con el mismo contrato y sin cargo. Ver [ambiente de pruebas](./mock.md).

## Ejemplo de consumo

```bash
curl -X POST https://api.consultaunica.mx/v3/phones \
  -H 'x-api-key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f' \
  -H 'Content-Type: application/json' \
  -d '{
    "variant": "ifetel",
    "ifetel": {
      "phoneNumber": "5512345678"
    }
  }'
```

## ✅ Respuestas exitosas. HTTP 200

### ☎ Teléfono fijo

```json
{
    "variant": "ifetel",
    "ifetel": {
        "phoneType": "Fijo",
        "phoneCompany": "Telmez",
        "registrationCity": null,
        "lada": null
    }
}
```

### 📱 Teléfono movil

```json
{
    "variant": "ifetel",
    "ifetel": {
        "phoneType": "Móvil",
        "phoneCompany": "TELCEL",
        "registrationCity": null,
        "lada": null
    }
}
```

::: tip Toda respuesta de error trae también `description` y `errorCode`
Los ejemplos que muestran solo `message` los omiten; revisa la [estructura de las respuestas de error](../start/index.md#estructura-de-las-respuestas-de-error).
:::

## ❌ Error de validación. HTTP 409

El teléfono no es de 10 dígitos

```json
{
    "message": "Datos inválidos, favor de verificar la información ingresada",
    "description": "Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.",
    "errorCode": "bad_request",
    "errors": [
        {
            "field": "body.ifetel.phoneNumber",
            "error": "String should have at least 10 characters"
        }
    ]
}
```

## ❌ Errores de la consulta de teléfono. HTTP 422

```json
{
    "message": "No se encontró un registro con los datos proporcionados"
}
```

## ❌ Error desconocido. HTTP 500

```json
{
    "message": "Algo falló durante la consulta, favor de consultar nuevamente"
}
```
