📞 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.

Ejemplo de consumo

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

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

📱 Teléfono movil

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

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.

❌ Error de validación. HTTP 409

El teléfono no es de 10 dígitos

{
    "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

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

❌ Error desconocido. HTTP 500

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