Ventas de eSIM

Descripción

Esta ruta devuelve el listado paginado de las ventas de eSIM realizadas, además del estado de activación de cada una, es decir, si la eSIM ya ha sido configurada en un dispositivo.

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

Todos los parámetros son query params y son opcionales.

Parámetro	Tipo	Ubicación	Requerido	Default	Descripción
`page`	number	Query	No	`1`	Página a consultar.
`limit`	number	Query	No	`20`	Registros por página. Máximo `100`.
`iccid`	string	Query	No	—	Filtra las ventas por el ICCID vendido.
`phone`	string	Query	No	—	Búsqueda parcial (contiene, sin distinguir mayúsculas) por el teléfono de contacto de la compra.
`email`	string	Query	No	—	Búsqueda parcial (contiene, sin distinguir mayúsculas) por el email de contacto de la compra.
`from`	string	Query	No	—	Fecha inicial del rango (formato ISO). Incluye ventas con fecha mayor o igual a `from`.
`to`	string	Query	No	—	Fecha final del rango (formato ISO). Incluye ventas con fecha menor o igual a `to`. Si no incluye hora, se toma el fin del día (inclusivo).

Ejemplo de Uso

Endpoint:

GETapidevstore.axiosmobile.mx/v2/transactions/esim-sales

GET /v2/transactions/esim-sales?page=1&limit=20&from=2026-10-01&to=2026-10-31 HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}

Body: No aplica

Respuestas

200 — Listado de ventas Success

Devuelve la página solicitada con el total de registros y las ventas.

{
  "page": 1,
  "limit": 20,
  "totalDocs": 57,
  "totalPages": 3,
  "docs": [
    {
      "folio": "100036a358d5f64d032661114acfc",
      "transactionStatus": "COMPLETED",
      "soldAt": "2026-10-21T18:30:20.925Z",
      "iccid": "8952140062227833246F",
      "contactName": "Juan Pérez",
      "contactPhone": "5512345678",
      "customerEmail": "juan@example.com",
      "activated": true,
      "sim": {
        "iccid": "8952140062227833246F",
        "msisdn": "5632158420",
        "imsi": "334140179156088",
        "pin": "1234",
        "puk": "63011475",
        "serie": "00361",
        "product": "ESIM",
        "qrLink": "https://axios-mobile.s3.us-east-2.amazonaws.com/esims/8952140062227833246F.png"
      }
    }
  ]
}

400 — Parámetros inválidos Client Error

Se retorna cuando page/limit no son enteros válidos, o cuando from/to no son fechas válidas o el rango es incoherente.

{ "error": "page inválido" }

{ "error": "limit inválido" }

{ "error": "from inválido (use una fecha ISO, p.ej. 2026-10-01)" }

{ "error": "to inválido (use una fecha ISO, p.ej. 2026-10-31)" }

{ "error": "El rango de fechas es inválido: from es posterior a to" }

401 — No autorizado Client Error

Se retorna cuando no se pudo identificar al usuario de la api-key.

{ "error": "No autorizado" }

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

500 — Error interno Server Error

Ocurrió un error inesperado al listar las ventas.

{
  "error": "Error al listar las ventas de eSIM",
  "details": "[mensaje del error]"
}

Parámetros de salida

Parámetro	Tipo	Descripción	Ejemplo
`page`	number	Página devuelta.	`1`
`limit`	number	Registros por página.	`20`
`totalDocs`	number	Total de ventas que cumplen el filtro.	`57`
`totalPages`	number	Total de páginas disponibles.	`3`
`docs`	array	Ventas de la página.	—
`docs[].folio`	string	Identificador único de la transacción en Axios.	`"100036a358d5f64d032661114acfc"`
`docs[].transactionStatus`	string	Estado de la transacción de venta.	`"COMPLETED"`
`docs[].soldAt`	string	Fecha y hora de la venta.	`"2026-10-21T18:30:20.925Z"`
`docs[].iccid`	string \| null	ICCID de la SIM vendida (`null` si la venta no asignó SIM).	`"8952140062227833246F"`
`docs[].contactName`	string \| null	Nombre de contacto capturado en la compra.	`"Juan Pérez"`
`docs[].contactPhone`	string \| null	Teléfono de contacto capturado en la compra.	`"5512345678"`
`docs[].customerEmail`	string \| null	Email de contacto capturado en la compra.	`"juan@example.com"`
`docs[].activated`	boolean	Estado actual de la SIM: `true` si está activada.	`true`
`docs[].sim`	object \| null	Detalle de la eSIM vendida (`null` si no hay SIM).	—
`docs[].sim.iccid`	string \| null	ICCID de la eSIM.	`"8952140062227833246F"`
`docs[].sim.msisdn`	string \| null	Número telefónico asignado.	`"5632158420"`
`docs[].sim.imsi`	string \| null	Identificador IMSI.	`"334140179156088"`
`docs[].sim.pin`	string \| null	PIN de la SIM.	`"1234"`
`docs[].sim.puk`	string \| null	Código PUK.	`"63011475"`
`docs[].sim.serie`	string \| null	Serie de la SIM.	`"00361"`
`docs[].sim.product`	string \| null	Tipo de producto.	`"ESIM"`
`docs[].sim.qrLink`	string \| null	URL pública del QR de activación.	`"https://axios-mobile.s3..."`

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v2/transactions/esim-sales?page=1&limit=20
Ventas de eSIM — Requiere API Key en el header x-api-key. Lista las ventas de esa api-key con el estado actual de cada SIM.
Query Parameters
Headers