ICTV Taxon Resolver

Lightweight showcase of the public ICTV Ontology API developed within the EVORA Project in collaboration with the International Committee on Taxonomy of Viruses (ICTV).

👉 Live demo: https://ictvapi.evora-project.eu

🌍 Overview

This simple static web interface demonstrates how the public ICTV API can resolve taxonomic terms and historical names.

It allows you to:

• Resolve the current version of an ICTV taxon from an identifier, a former taxon name, a virus name, synonyms, or NCBI Taxon mappings
• Retrieve full ontology term details, including lineage
• Visualize relationships and term history

🔧 How it works

The resolver uses:

• JavaScript ICTV API helper: ictv-api.js — lightweight ES module for querying the ICTV API (Note: this file must be imported with type="module" and a named export.).
• JavaScript UI: from this code repository
• Ontology source: ICTV Ontology
• API Endpoint: OLS4 ICTV Ontology API.
• API Documentation: https://www.ebi.ac.uk/ols4/api-docs
• Data license: CC BY 4.0 — International Committee on Taxonomy of Viruses (ICTV)

The interface is deployed via GitHub Pages.

🧩 Integration

To use the ICTV API helper in your own project, import it as an ES module:

<script type="module">
  import { ICTVApi } from "https://cdn.jsdelivr.net/gh/EVORA-project/ictv-ontology/helpers/js/ictv-api.js";

  const api = new ICTVApi();
  const result = await api.resolveToLatest("Zika virus");
  console.log(result);
</script>

Why this syntax?

• ictv-api.js is an ES module, so it must be loaded with type="module".

• The helper exports a named class ({ ICTVApi }), not a default export.

• You can use top-level await inside module scripts.

For more advanced usage, see the helper documentation.

ℹ️ You can also clone this repository and adapt the UI directly for your use case.

---

Disclaimer

This work was carried out within the EVORA Project – European Viral Outbreak Response Alliance – in collaboration with the ICTV.

Data sources © ICTV — CC BY 4.0