API de resultados de loterías de Colombia

Endpoints

Autenticación con la cabecera X-Api-Key. Respuestas en JSON, codificación UTF-8, fechas en zona horaria de Colombia.

Documentación completa (parámetros, códigos de error y ejemplos con curl) y la especificación en OpenAPI 3.1, por si prefieres generar tu cliente. Las dos son públicas: no hace falta ser cliente para leerlas.

Formato de respuesta

GET /v1/results/loteria-de-boyaca/2026-08-15

{
  "draw": "loteria-de-boyaca",
  "name": "Lotería de Boyacá",
  "category": "loteria",
  "draw_date": "2026-08-15",
  "draw_number": "2885",
  "winning_number": "3947",
  "winning_series": "142",
  "top_prize": 15000000000,
  "secondary_prizes": [
    { "label": "SECO DE $100 MILLONES", "type": "secondary",
      "number": "6968", "series": "380", "amount": 100000000 }
  ],
  "status": "confirmed",
  "published_at": "2026-08-15T23:52:11-05:00"
}

El campo status vale preliminary mientras el resultado está pendiente de verificación y confirmed una vez verificado contra la fuente oficial del sorteo. Tu integración decide con cuál de los dos actúa.

Webhooks

Si tu producto notifica a usuarios, no hace falta que preguntes: te avisamos nosotros. En el momento en que se publica un resultado enviamos un POST a la URL que nos indiques, firmado con HMAC-SHA256 para que puedas validar el origen, y con reintentos si tu extremo no responde.

La suscripción puede ser a sorteos concretos o a todos, y se configura en la puesta en marcha. Incluido en el plan Profesional y en los planes a la medida.

Integridad del dato

Un resultado equivocado le cuesta más a quien lo publica que un resultado que llega tarde. Ningún dato se publica sin superar tres controles automáticos de fecha, consistencia y contraste, y el archivo se audita además de forma periódica.

Cuando un resultado no supera esos controles no se publica: el archivo queda con un hueco declarado en vez de con un número falso. Por eso cada resultado viaja con su campo status, y tu integración decide con qué grado de certeza actúa.

Planes

Precios en pesos colombianos.

Uso y licencia

Puedes almacenar los resultados en tu propia base de datos y utilizarlos para prestar tu servicio, sea una aplicación, un sitio web o un análisis interno. Dos condiciones:

• Atribución. Un enlace visible a LoteríaYa en la sección donde muestres los resultados.
• Sin redistribución. El conjunto de datos no se revende ni se redistribuye a terceros como producto de datos. El límite está entre usarlo dentro de tu producto y venderlo como tal.

Ambas quedan por escrito en el acuerdo de servicio.