Validar Compatibilidad de IMEI

Descripción

Este método permite validar si un IMEI es compatible con la red de Axios Mobile (Altan) antes de continuar con la activación de la eSIM. Consulta el estado del dispositivo (bloqueado, homologado, soporte VoLTE y banda 28) y regresa si es compatible junto con un mensaje explicativo para mostrar al cliente.

URL API

BASE URLhttps://apidevstore.axiosmobile.mx/v2

Autenticación

Comportamiento por entorno

IMEIs de prueba (solo fuera de producción)

Puedes forzar un veredicto específico usando estos IMEIs de prueba:

IMEI (en la URL)	Resultado simulado	`compatible`
`010510007236140`	Equipo NO compatible (Nokia 1100)	`false`
Cualquier otro valor válido	Equipo compatible (iPhone 18 Pro Max)	`true`

Parámetros de entrada

Parámetro	Tipo	Ubicación	Requerido	Descripción	Ejemplo
`imei`	string	Path param	Sí	IMEI del dispositivo a validar. Debe contener solo dígitos, entre 14 y 17 caracteres.	`"358240051111110"`

Ejemplo de Uso

Endpoint:

GETapidevstore.axiosmobile.mx/v2/compatibility/imei/:imei

GET /v2/compatibility/imei/357565510036966 HTTP/1.1
Host: apidevstore.axiosmobile.mx

Headers: No aplica
Body: No aplica

Respuestas

{
  "imei": {
    "imei": "357565510036966",
    "homologated": "COMPATIBLE PROBADO",
    "blocked": "NO",
    "sub_category": "Voz y Datos",
    "soportaESIM": "SI"
  },
  "deviceFeatures": {
    "volteCapable": "SI",
    "band28": "SI",
    "model": "iPhone 18 Pro Max",
    "brand": "Apple"
  },
  "compatible": true,
  "message": "Su equipo es compatible con nuestra red AXIOS, puede que necesite algunas configuraciones extras al insertar la SIM en el teléfono."
}

{
  "imei": {
    "imei": "01051000723614",
    "homologated": "NO COMPATIBLE",
    "blocked": "NO",
    "sub_category": "No Recomendado",
    "soportaESIM": "NO"
  },
  "deviceFeatures": {
    "volteCapable": "NO",
    "band28": "NO",
    "model": "1100",
    "brand": "Nokia"
  },
  "compatible": false,
  "message": "Lo sentimos, tu equipo no es compatible, pero tienes la opción de continuar."
}

Condición evaluada	`compatible`	`message`
No homologado (`homologated` distinto de `HOMOLOGADO`/`VOLTE`/`COMPATIBLE`)	`false`	”Lo sentimos. Su equipo no es compatible con nuestra red AXIOS.”
`blocked` es `"SI"`	`false`	”El dispositivo se encuentra bloqueado, no puede ser utilizado en nuestra red AXIOS.”
Homologado + `volteCapable: SI` + `band28: SI`	`true`	”Su equipo es compatible con nuestra red AXIOS.”
`volteCapable: NO` + `band28: SI` + marca `Apple`	`false`	”Lo sentimos. Su equipo no es compatible con nuestra red AXIOS.”
`volteCapable: NO` + `band28: SI` + marca distinta de Apple (Android)	`true`	”Su equipo no cuenta con VoLTE(tecnología necesaria para realizar llamadas).”
Ninguna de las anteriores	`false`	”No pudimos determinar si el equipo es compatible. Por favor contactar a servicio al cliente.”

400 — Formato de IMEI incorrecto Client Error

Se retorna cuando el imei recibido no cumple el formato esperado (solo dígitos, entre 14 y 17 caracteres). Esta validación ocurre antes de consultar a Altan.

{ "error": "Formato de IMEI incorrecto" }

400 — Errores devueltos por Altan Client Error

Se retornan cuando Altan rechaza la solicitud por el formato del IMEI o porque no encuentra información asociada.

Formato inválido para Altan
IMEI no encontrado

{ "error": "El formato del imei no es el correcto" }

{ "error": "IMEI no encontrado" }

429 — Demasiadas peticiones Client Error

Se retorna cuando se supera el límite de 60 peticiones por minuto por IP.

{ "error": "Too many requests, please try again later" }

500 — Error Interno Server Error

Se retorna cuando ocurre un error inesperado al comunicarse con Altan que no coincide con los casos anteriores (por ejemplo, timeout o caída del servicio).

{ "error": "Ocurrió un error en el servidor" }

Parámetros de salida (Respuesta Exitosa)

La respuesta regresa el objeto directamente (sin envoltura), organizado en dos objetos —imei y deviceFeatures— más el veredicto de compatibilidad al nivel raíz (compatible y message):

{
  "imei": {
    "imei": "357565510036966",            // string — IMEI consultado
    "homologated": "COMPATIBLE PROBADO",  // string — estado de homologación del dispositivo
    "blocked": "NO",                      // string — "SI" / "NO": si el equipo está bloqueado
    "sub_category": "Voz y Datos",        // string — categoría de servicio del equipo
    "soportaESIM": "SI"                   // string — "SI" / "NO": si el equipo soporta eSIM
  },
  "deviceFeatures": {
    "volteCapable": "SI",                 // string — "SI" / "NO": soporte de VoLTE
    "band28": "SI",                       // string — "SI" / "NO": soporte de banda 28
    "model": "iPhone 18 Pro Max",         // string — modelo del dispositivo
    "brand": "Apple"                      // string — marca del dispositivo
  },
  "compatible": true,                     // boolean — veredicto final de compatibilidad
  "message": "Su equipo es compatible..." // string — mensaje listo para mostrar al cliente
}

imei — estado del dispositivo según Altan

imei · string — IMEI consultado.
homologated · string — estado de homologación (p. ej. "COMPATIBLE PROBADO", "HOMOLOGADO", "VOLTE").
blocked · string — "SI" / "NO": indica si el dispositivo está bloqueado.
sub_category · string — categoría del servicio que soporta el equipo (p. ej. "Voz y Datos").
soportaESIM · string — "SI" / "NO": indica si el dispositivo soporta eSIM.

deviceFeatures — características técnicas

volteCapable · string — "SI" / "NO": soporte de VoLTE (necesario para llamadas).
band28 · string — "SI" / "NO": soporte de la banda 28.
model · string — modelo del dispositivo.
brand · string — marca del dispositivo.

Veredicto de compatibilidad

compatible · boolean — resultado final: si el dispositivo es compatible con la red AXIOS.
message · string — mensaje explicativo listo para mostrar al cliente.

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v2/compatibility/imei/:imei
Validar compatibilidad de IMEI (v2) — Endpoint público, no requiere autenticación.
Parámetros de ruta
:imei
Headers