API pública · v1

API pública laudos.co

Acceso programático al corpus arbitral colombiano: laudos, árbitros, centros, jurisprudencia (CC + CSJ) y datos canónicos publicados bajo CC BY 4.0. Más de 45 endpoints REST documentados, con ejemplos en curl, Python y JavaScript.

Endpoints
45
REST
Laudos arbitrales
2.560cached
documentos
Árbitros únicos
1.882cached
identificados
Jurisprudencia
2.788cached
CE + CC + CSJ
base URL:https://cristianjosue07--laudos-api-fastapi.modal.run

Endpoints populares

Los 10 endpoints más consultados. Cada tarjeta trae un curl listo para copiar; para snippets en Python/JS o ejecutar en vivo, salta al catálogo completo o al Swagger UI.

Explorar todos en Swagger UI →
GET/api/health

Health check del backend + métricas vivas del corpus: total de documentos indexados, modelos cargados y versión del servicio.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/health' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/stats/public

Cifras canónicas auditadas del corpus: laudos, árbitros, centros, decisiones, cuantías, duraciones. Fuente única para citas y dashboards.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/stats/public' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/laudos?limit=20

Listado paginado de laudos arbitrales con metadata clave (centro, año, partes, materia, decisión). Soporta filtros por centro, año, materia.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/laudos?limit=20' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/arbitros?limit=20

Directorio de árbitros con track-record agregado: # laudos, mediana de duración, tasa de prosperidad de las pretensiones, materias frecuentes.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/arbitros?limit=20' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/arbitro/{id}/stats

Track-record cuantitativo de un árbitro: número de laudos, decisiones favorables, mediana de cuantías concedidas, materias dominantes.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/arbitro/arb_garrido_andres/stats' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/arbitro/{id}/bio

Bio estructurada del árbitro: formación, áreas de práctica, afiliaciones, idiomas, fuentes (centros donde figura como árbitro).

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/arbitro/arb_garrido_andres/bio' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/arbitro/{id}/export.json

Dossier completo de un árbitro en un solo JSON: bio + stats + lista de laudos + decisiones detalladas. Ideal para due-diligence offline.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/arbitro/arb_garrido_andres/export.json' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
POST/api/search

Búsqueda híbrida BM25 + densa con re-ranking opcional sobre todo el corpus (laudos + jurisprudencia). Acepta filtros por fuente, materia, año.

curl example
curl -sS -X POST 'https://cristianjosue07--laudos-api-fastapi.modal.run/search' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
  -H 'Content-Type: application/json' \
  -d '{
         "query": "imprevision contractual obras civiles",
         "top_k": 10,
         "mode": "hybrid",
         "rerank": true
       }'
Probar interactivo en el catálogo →
GET/api/precedentes?limit=10

Precedentes destacados: laudos con citaciones altas o decisiones reiteradas. Útil como entrypoint a la red de doctrina arbitral.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/precedentes?limit=10' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →
GET/api/laudos/ranking?by=monto_concedido&limit=10

Ranking de laudos por dimensión: monto concedido, duración, número de árbitros, complejidad. Para reportería y comparativos sectoriales.

curl example
curl -sS -X GET 'https://cristianjosue07--laudos-api-fastapi.modal.run/laudos/ranking?by=monto_concedido&limit=10' \
  -H 'X-API-Key: lk_live_***' \  # opcional para endpoints públicos
Probar interactivo en el catálogo →

Swagger UI interactivo

Documentación viva del backend FastAPI. Probá cualquier endpoint con tu API key, inspeccioná schemas request/response y descargá el OpenAPI spec.

https://cristianjosue07--laudos-api-fastapi.modal.run/docscargando…
Swagger UI corre en sandbox separado. Tu API key del catálogo interno no se comparte por seguridad. Pegala manualmente en el botón Authorize.

Política de uso y citación

Los datos canónicos del corpus se publican bajo licencia abierta. Te pedimos citar la fuente para que terceros puedan verificar y replicar.

CC BY 4.0

Licencia de datos canónicos

Cifras canónicas, agregados y metadata estructurada se publican bajo Creative Commons Attribution 4.0. Podés usarlos comercialmente, redistribuirlos y derivar trabajos siempre que acredites la fuente y mantengas la licencia.

  • Textos completos de laudos conservan la titularidad original del centro de arbitraje correspondiente.
  • Bios y track-records de árbitros son datos factuales agregados, no opiniones.
  • Predicciones y embeddings son derivados estadísticos, sin valor probatorio.

Rate limits resumidos

Sin API key
acceso anónimo a endpoints públicos
100 req/min
Free tier (con key)
registro gratis en /api-keys
1.000 req/min
10K req/h
PRO tier
acceso a search v3, predicciones, dossiers
10.000 req/h
+ endpoints PRO

Headers de respuesta X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset indican el estado actual. Al agotar el cupo, el backend devuelve 429.

Formato de citación sugerido

APA 7
laudos.co. (2026). laudos.co — Corpus arbitral colombiano [Dataset]. https://laudos.co (CC BY 4.0).
BibTeX
@misc{laudos_co_2026,
  title        = {laudos.co — Corpus arbitral colombiano},
  author       = {{laudos.co}},
  year         = {2026},
  url          = {https://laudos.co},
  note         = {Datos canónicos bajo CC BY 4.0. Acceso vía API REST.}
}

Disclaimers

  • Corpus actualizado mensualmente. Ver /changelog para el detalle por release.
  • Las predicciones del modelo son orientativas, no constituyen asesoría legal.
  • Centros de arbitraje conservan la titularidad de los textos completos.
  • Cifras canónicas reproducibles desde el snapshot público en /transparencia.

¿Vas a integrar?

Por ahora no publicamos SDKs oficiales, pero la API es REST estándar y el OpenAPI spec permite generar clients en cualquier lenguaje con openapi-generator o openapi-typescript. Si publicás un wrapper, contanos.

Catálogo completo

Los 45 endpoints organizados por categoría, con playground interactivo, snippets en Python / JavaScript y persistencia de estado por endpoint.

laudos.co/api-docs
Verificando…OpenAPI

API laudos.co · Playground interactivo

Acceso programático al corpus arbitral colombiano. Cada endpoint trae documentación, ejemplos en curl, Python y JavaScript, y un botón Ejecutar que lo lanza en vivo desde el navegador (sin CORS).

base URL: https://cristianjosue07--laudos-api-fastapi.modal.run45 endpoints9 categorías
Autenticación

La mayoría de los endpoints aceptan o requieren una API key. Pasala como header X-API-Key en cada request. La key se persiste en sessionStorage del navegador y se borra al cerrar la pestaña.

Crear API key →

Rate limits

Cada tier acumula requests en una ventana deslizante de 1 hora. Cuando el límite se agota, el backend devuelve 429 Too Many Requests.

TierRequests / horaAprox. por minutoOpen DataModelo chat
Free1.000~16 req/minManifest + centrosSonnet (base)
PRO10.000~165 req/minTodos los datasetsSonnet + Opus

Límites verificados en src/laudos_ccm/api.py (S14_RATE_LIMIT_MAX). Sujetos a cambios; los headers X-RateLimit-* de cada response son la fuente autoritativa.

Busqueda

Busqueda hibrida BM25 + embeddings sobre laudos y jurisprudencia.

Laudos

Acceso al corpus de laudos y providencias.

Directorios

Arbitros, partes y centros de arbitraje.

CC / CSJ

Sentencias de la Corte Constitucional y Corte Suprema.

Analisis

Comparativos, sectores y exploracion de relaciones.

Lab predictivo

Laboratorio de prediccion y backtesting.

Chat & Ask

Q&A en lenguaje natural sobre el corpus, con citas verificables.

Open Data

Datasets descargables (manifest + CSV/JSON).

Sistema

Health, status y diagnostico.