Database Description, API Access, and Downloads

This page documents the meaning of each fileds (columns) used in the variant databases available in PubMind.

For the column that has | in it, it means the aggregated value for each record of a variant. The order of different columns should match. For example, the order in column formatted_reference should match with LLM_reasoning and pathogenicity.

Common Fileds for All Variant Types

SNV Specific Fileds

Gene Fusion Specific Fileds

SV & CNV Specific Fileds

Genomic (Coordinate) Specific Fields

API access

PubMind-DB provides summary-level API endpoints for programmatic access. The API returns aggregate counts, pathogenicity scores, and links back to the PubMind-DB website. Detailed per-record information is not returned through the API; please use the PubMind-DB website for detailed records.

Database release. Every response carries a db_version field naming the release that produced it. Without a version parameter the API serves the current release (1.1.1), which means a request will move to the next release when one ships. Add version= to pin a release — recommended for anything reproducible, such as results cited in a manuscript. Available releases: 1.1.1, 1.0.0. An unrecognised value returns 400 with the list of valid releases rather than quietly falling back to the default.

curl "https://pubmind.wglab.org/api/summary?query=ACVR1&field=gene&version=1.1.1"
curl "https://pubmind.wglab.org/api/pvid/PVID118384?version=1.1.1"

A v1.0.0 PVID that no longer exists in the current release does not simply fail: the API answers 301 with new_PVID and a retry_url if it was renumbered, or 410 with status: retired if the variant is no longer reported.

Example: summary search for the BRCA1 gene.

curl "https://pubmind.wglab.org/api/summary?query=BRCA1&field=gene"

The same request can be opened directly in a browser:

https://pubmind.wglab.org/api/summary?query=BRCA1&field=gene

Example: summary lookup for PVID118384.

curl "https://pubmind.wglab.org/api/pvid/PVID118384"

The same PVID request can be opened directly in a browser:

https://pubmind.wglab.org/api/pvid/PVID118384

Database Access and Downloads

If you have questions or suggestions, please visit the GitHub repo.