2. Disponibilidad

`GET /v1/availability`

Devuelve el plan eSIM más barato para la duración que pides entre los que cubren el destino, con el precio de una eSIM, por día y para toda la duración. Cada plan trae un token que recuerda tu búsqueda: lo enviarás en el prebooking, donde eliges cuántas eSIM comprar.

Parámetros

Parámetro	Obligatorio	Descripción
`country`	Sí	Id del país (entero, de la guía de países). Repítelo para varios países (de 1 a 50): `country=83&country=84`. El plan devuelto cubre todos ellos.
`startDate`	Sí	Primer día de cobertura, `yyyy-MM-dd`. Puede ser hoy; no puede estar en el pasado.
`days`	Sí	Días de cobertura (entero de 1 a 999). Solo se consideran los planes que tienen precio para esa duración exacta, y solo se devuelve ese precio.

Petición

curl -s -u "mi-usuario:mi-secreto" \
  "https://pre-api.welcomesims.com/public-api/v1/availability?country=83&startDate=2026-12-01&days=15"

Respuesta `200`

[
  {
    "id": 167,
    "name": "W ESIM VIRTUAL JAPON (DATOS ILIMITADOS)",
    "price": { "days": 15, "pricePerDay": "2.19", "totalPrice": "32.89" },
    "countries": [ { "id": 83, "name": "Japón", "code": "JP" } ],
    "token": "eyJwbGFuSWQiOjE2NywicGxhblByaWNlSWQiOjE0MjksImNvdW50cnlJZHMiOls4M10sInN0YXJ0RGF0ZSI6IjIwMjYtMTItMDEiLCJkYXlzIjoxNX0"
  }
]

Todos los campos de cada plan vienen siempre. Los importes son texto con dos decimales.

Campo	Descripción
`id`	Id del plan (entero).
`name`	Nombre del plan.
`price.days`	Días de cobertura del precio.
`price.pricePerDay`	Precio de una eSIM por día, en euros con dos decimales y con los impuestos que corresponden a tu cuenta.
`price.totalPrice`	Precio de una eSIM para toda la duración, en euros con dos decimales y con impuestos. El prebooking calcula el importe de las eSIM que elijas multiplicándolo por su número.
`countries`	Países que cubre el plan: cada uno con `id` y `name` siempre, y `code` solo si existe (ver la guía de países).
`token`	Recuerda esta búsqueda y este plan: lleva el plan, el precio, los países que buscaste, la fecha de inicio y los días. Envíalo tal cual en el prebooking; no lo interpretes ni lo modifiques.

Cosas a tener en cuenta

La respuesta es una lista de planes. Una lista vacía ([]) significa que no hay ningún plan con precio para esa búsqueda; no es un error.
Si startDate está en el pasado recibirás un 400 con "code": "INVALID_REQUEST".
Cada llamada genera un token nuevo por plan. Si tu cliente cambia de opinión (otros países, otras fechas u otra duración), repite la búsqueda y usa el token nuevo.