Estado de activación de SIM

Descripción

Este método permite consultar el estado de activación de una SIM a partir de su iccid o su msisdn. Devuelve si la SIM está activa y, cuando corresponde, la fecha de primer uso.

Es útil para confirmar, antes o después de una activación, que una línea quedó efectivamente activa en la plataforma.

URL API

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

Autenticación

Este endpoint se autentica mediante API Key.

Mecanismo	Header	Descripción
API Key	`x-api-key: {{apiKey}}`	Clave de API asignada a tu cuenta

Envía la clave en el header x-api-key en cada solicitud. No hay flujo de login previo. Solicita tu clave contactando al equipo de soporte Axios.

Situación	Código
Header `x-api-key` ausente	`401`
Clave inválida o no habilitada	`403`

Parámetros de Entrada

Envía uno de los siguientes parámetros de consulta (query params):

Parámetro	Tipo	Ubicación	Requerido	Descripción
`iccid`	string	Query param	Uno de los dos	ICCID de la SIM a consultar.
`msisdn`	string	Query param	Uno de los dos	Número telefónico (MSISDN) de la SIM a consultar.

Ejemplo de Uso

Endpoint:

GETapidevstore.axiosmobile.mx/v2/sims/status?iccid=:iccid

GET /v2/sims/status?iccid=8952140061854746820F HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}

Body: No aplica

Respuestas

200 — SIM activa Success

La SIM tiene activated = true.

{
  "activated": true,
  "message": "La SIM está activa.",
  "iccid": "8952140061854746820F",
  "msisdn": "5639845781",
  "firstUseDate": "2026-01-02T10:15:30.000Z"
}

200 — SIM no activa Success

La SIM existe pero activated no es true.

{
  "activated": false,
  "message": "La SIM no está activa"
}

400 — Parámetros faltantes Client Error

No se envió iccid ni msisdn.

{ "error": "Debes enviar iccid o msisdn" }

404 — SIM no encontrada Client Error

No existe una SIM con el iccid o msisdn enviado.

{ "message": "SIM no encontrada" }

429 — Demasiadas peticiones Client Error

Se retorna cuando se supera el límite de 60 peticiones por minuto por usuario (tu API Key).

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

Parámetros de Salida

Parámetro	Tipo	Descripción	Ejemplo
`activated`	boolean	Indica si la SIM está activa.	`true`
`message`	string	Mensaje descriptivo del estado.	`"La SIM está activa."`
`iccid`	string	ICCID de la SIM.	`"8952140061854746820F"`
`msisdn`	string	MSISDN de la SIM.	`"5639845781"`
`firstUseDate`	string	Fecha de primer uso (ISO 8601).	`"2026-01-02T10:15:30.000Z"`

Resumen de Códigos de Respuesta

Código HTTP	Significado	Acción recomendada
`200`	SIM activa / no activa (ver `activated`).	Ninguna.
`400`	Falta `iccid` o `msisdn`.	Incluir uno de los dos.
`404`	SIM no encontrada.	Verificar el identificador enviado.
`429`	Límite de peticiones excedido.	Esperar 1 minuto y reintentar.

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v2/sims/status
Estado de activación de SIM — Requiere API Key en el header x-api-key. Envía iccid o msisdn.
Query Parameters
Headers