AI Observatory Costa Rica
Return to the observatory

Public data archive / API 0.1.0

Public evidence, ready to query

Eleven evidence collections and one codebook document the catalog, public policy, sources and the observatory’s editorial work.

A human-readable interface for journalists, researchers, developers and organizations that need to examine or reuse the observatory’s evidence.

documented JSON routes
12
data license
CC BY 4.0
read access without authentication
GET

01 / Collections

Twelve routes, one stable contract

Each count uses the unit declared for that file. Counts should not be added across collections or treated on their own as verified AI adoption.

  1. Open JSON

    Catalog of AI-related initiatives in Costa Rica’s public sector. It includes systems, pilots, plans and capabilities with bilingual ES/EN descriptions and traceable public sources.

    Contents
    31 initiatives
    Editorial cutoff
    Publication
    2026-09-01-r11
  2. Open JSON

    Public institutions with documented AI-related initiatives, including ministries, autonomous institutions, the judiciary, universities and research bodies.

    Contents
    11 institutions
    Editorial cutoff
    Publication
    2026-09-01-r11
  3. Open JSON

    AI-related bills in Costa Rica’s Legislative Assembly. Monitors propose signals, while every published status requires editorial review against an official source.

    Contents
    7 bills
    Editorial cutoff
    Publication
    2026-09-01-r11

  5. Comparative gaps

    /api/brechas.json

    Open JSON

    Analysis of seven capabilities not documented as operational in Costa Rica, benchmarked against Estonia and Singapore.

    Contents
    7 gaps
    Editorial cutoff
    Publication
    2026-09-01-r11

  6. ENIA Action Plan

    /api/enia-acciones.json

    Open JSON

    Inventory and crosswalk of the ENIA Action Plan: 129 records from the official document, 120 unique interventions, type classification, execution evidence and catalog relationships.

    Contents
    129 source records
    Editorial cutoff
    Publication
    2026-09-01-r11

  7. Editorial monitoring

    /api/monitoreo.json

    Open JSON

    Editorial schedule and log, including cadence by monitoring front, upcoming reviews, status changes and documented no-change reviews.

    Contents
    8 monitoring fronts
    Editorial cutoff
    Publication
    Rolling log

  8. Country framework

    /api/marco-pais.json

    Open JSON

    Public architecture of Costa Rica’s AI framework, including layers, milestones, instruments, related references and operational gaps.

    Contents
    4 sections
    Editorial cutoff
    Publication
    2026-09-01-r11

  9. Editorial history

    /api/historial.json

    Open JSON

    Public bilingual log of editorial changes, with date, type, source and commit when available.

    Contents
    48 published changes
    Editorial cutoff
    Publication
    2026-09-01-r11

  10. Current affairs

    /api/coyuntura.json

    Open JSON

    Dated, traceable editorial notes that add public context without replacing official bill or initiative status.

    Contents
    2 notes
    Editorial cutoff
    Publication
    2026-09-01-r11

  11. Resources and sources

    /api/recursos.json

    Open JSON

    Directory with stable IDs for documents, regulations, indicators and sources used by the observatory.

    Contents
    16 resources
    Editorial cutoff
    Publication
    2026-09-01-r11

  12. Codebook and methodology

    /api/codebook.json

    Open JSON

    Bilingual dictionary for the contract, controlled vocabularies, verified-adoption rule, provenance and interpretation limits.

    Contents
    11 documented datasets
    Editorial cutoff
    Publication
    2026-09-01-r11

02 / Contract

How to read a response

Every endpoint uses the same envelope. The data field preserves the natural structure of each dataset.

{
  "version": "0.1.0",
  "lastUpdate": "2026-09-01T00:00:00.000Z",
  "count": 29,
  "source": "https://observatorioia.org",
  "license": "CC BY 4.0",
  "data": [ ... ]
}
version
Application version that generated the export.
lastUpdate
Date of the latest known editorial change, not the build time.
count
Quantity according to the unit declared by the endpoint.
source
Site responsible for publishing the dataset.
license
Terms governing reuse of the data.
data
Complete collection or document returned by the endpoint.

Interpretation rules

  • Public text is delivered as bilingual objects with es and en fields.
  • In the catalog, existence, execution, AI technique, operational use, results and governance are assessed separately.
  • Undetermined means the available public evidence cannot confirm or rule out a claim.
  • Not applicable means a dimension does not correspond to the documented initiative type; it is not an open research gap.
  • Sources identify the dimensions they support. Confirming execution requires at least one official primary or freedom-of-information source; news and vendor sources may only supplement that evidence.

03 / Query

Reproducible examples

These routes are static files. They work from a terminal, an analysis notebook, a spreadsheet with JSON import or any HTTP client.

Download the catalog

Returns the complete initiatives envelope.

curl -s https://observatorioia.org/api/proyectos.json

Consume from JavaScript

Reads data and editorial date without relying on field order.

const response = await fetch(
  'https://observatorioia.org/api/proyectos.json'
);
const { data, lastUpdate } = await response.json();

Reproduce verified adoption

Applies the substantive conditions published in the codebook. The export has already passed the traceability validation that completes the rule.

curl -s https://observatorioia.org/api/proyectos.json |
  jq '.data[] |
    select(.modeloVersion == 2) |
    select(.estadoCatalogo == "verificado") |
    select(.tipoIniciativa == "sistema-ia" or
           .tipoIniciativa == "componente-ia") |
    select(.faseImplementacion == "piloto" or
           .faseImplementacion == "operativo") |
    select(.estadoIA == "confirmada") |
    select(.evaluacion.tecnicaIA.estado == "confirmado") |
    select(.evaluacion.ejecucion.estado == "confirmado") |
    select(. as $iniciativa |
      [.fuentes[] |
        select(
          (.tipoFuente == "primaria-oficial" or
           .tipoFuente == "acceso-informacion") and
          (.respalda | index("ejecucion")) and
          (.id as $fuenteId |
            $iniciativa.evaluacion.ejecucion.fuenteIds |
            index($fuenteId))
        )
      ] | length > 0
    ) |
    {id, titulo, faseImplementacion, fechaUltimaVerificacion}'

04 / Reuse

Attribution, limits and contact

How to cite

AI Observatory Costa Rica, dataset consulted, release or editorial cutoff date and direct endpoint URL. CC BY 4.0 covers the compilation; each source document retains its own terms.

What the API does not claim

The catalog includes verified adoptions, initiatives under review and ecosystem capabilities. The total number of documented initiatives is not the number of operational AI systems.

Editorial maintenance

Monitors generate signals. No scraper creates, reclassifies or verifies an initiative automatically; the rolling log records approved reviews and substantive changes require a new release.

Questions about data or methodology: info@observatorioia.org