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 utility for querying the ICTV API.
• 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

If you want to use the ICTV API in your own project, simply include:

<script src="https://cdn.jsdelivr.net/gh/EVORA-project/ictv-ontology/helpers/js/ictv-api.js"></script>

And then call:

const api = new ICTVApi();
const result = await api.resolveToLatest('Zika virus');
console.log(result);

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