ThermoMutDB guide
Tutorial and data reference
Learn how to access ThermoMutDB and interpret the records returned by the API.
General tutorial coming soon
We are preparing a new overview of ThermoMutDB 2.0, including browsing, record details, data contribution, and curation workflows. The API and data references are already available in the tabs above.
REST API v1
Query the unified records endpoint
ThermoMutDB exposes the MongoDB flatdata collection through one endpoint.
Filters are query parameters and can be combined in the same request.
/thermomutdb/api/v1/records
Search records with filters and pagination.
/thermomutdb/api/v1/records/<id>
Retrieve one record by its numeric ThermoMutDB ID.
Common requests
Repeat an exact-match parameter to search for multiple values.
curl "https://thermomutdb-dev.pathotrack.health/thermomutdb/api/v1/records?mutation_code=H48N&mutation_code=D36N&per_page=25"Text filters are case-insensitive. Numeric fields use _min and _max.
curl "https://thermomutdb-dev.pathotrack.health/thermomutdb/api/v1/records?protein=lysozyme&year_min=2020&ddg_min=-2&ddg_max=2"curl "https://thermomutdb-dev.pathotrack.health/thermomutdb/api/v1/records/1"Filter types
| Type | Parameters |
|---|---|
| Exact, repeatable | mutation_code, uniprot, pdb, pdb_mutant, mutated_chain, pmid |
| Exact | mutation_type, effect |
| Text search | protein, source, method, measure, sst, doi, reference |
| Numeric range | ddg, dtm, temperature, ph, year, mut_count, length, rsa, phi, psi, res_depth, ca_depth |
Response format
{
"total": 4,
"page": 1,
"per_page": 25,
"rows": [
{ "id": 123, "mutation_code": "H48N", "ddg": 1.2 }
]
}
Pagination starts at page 1. per_page defaults to 100 and is limited to 500.
Invalid parameters return HTTP 400; missing record IDs return HTTP 404.
MongoDB flatdata
ThermoMutDB record fields
Each API row is a denormalized mutation experiment record. Fields can be absent when the
source publication does not report a value. The MongoDB internal _id is not returned.
| Group | API field | Description | Unit | Query filter |
|---|---|---|---|---|
| Protein and record | id | ThermoMutDB record identifier | - | Use /records/<id> |
protein | Protein name | - | protein | |
source | Source organism | - | source | |
uniprot | UniProt accession | - | uniprot | |
PDB_wild | Wild-type Protein Data Bank code | - | pdb or PDB_wild | |
pdb_mutant | Experimental or generated mutant structure code | - | pdb_mutant | |
length | Protein sequence length | residues | length_min, length_max | |
weight | Molecular weight when available | source-defined | - | |
| Mutation | mutation_code | One-letter mutation notation, including comma-separated multiple mutations | - | mutation_code |
mutation_type | Single, Double, or Multiple mutation classification | - | mutation_type | |
mut_count | Number of substitutions in the record | - | mut_count_min, mut_count_max | |
mutated_chain | Protein chain containing the mutation | - | mutated_chain | |
mutation_based | Source used to map the mutation | - | - | |
effect | Experimental stabilizing or destabilizing effect | - | effect | |
| Experimental conditions | temperature | Experimental temperature | K | temperature_min, temperature_max |
ph | Experimental pH | - | ph_min, ph_max | |
method | Protein denaturation method | - | method | |
measure | Experimental measurement technique | - | measure | |
| Thermodynamics | ddg | Change in Gibbs free energy caused by mutation | kcal/mol | ddg_min, ddg_max |
dtm | Change in melting temperature caused by mutation | K | dtm_min, dtm_max | |
foldx_ddg | Computed FoldX stability change when available | kcal/mol | - | |
| Structural environment | sst | Secondary structure classification | - | sst |
rsa | Relative solvent accessibility | % | rsa_min, rsa_max | |
phi | Backbone phi angle | degrees | phi_min, phi_max | |
psi | Backbone psi angle | degrees | psi_min, psi_max | |
res_depth | Average wild-type residue depth from the solvent-accessible surface | angstrom | res_depth_min, res_depth_max | |
ca_depth | Alpha-carbon depth from the solvent-accessible surface | angstrom | ca_depth_min, ca_depth_max | |
relative_bfactor | Relative crystallographic temperature factor | - | - | |
| Literature | reference | Publication reference | - | reference |
year | Publication year | - | year_min, year_max | |
PMID | PubMed identifier | - | pmid or PMID | |
DOI | Digital Object Identifier | - | doi or DOI | |
other_links | Additional source links when available | - | - | |
| Derived scores | blosum62 | BLOSUM62 substitution score | - | - |
pam250 | PAM250 substitution score | - | - | |
pos, neg, acc, don, aro, sul, neu | Pharmacophore property-change scores | - | - |
pdb_mutant_generated,
pdb_mutant_method, pdb_mutant_generated_at, and foldx_energy_terms.
Curated v2 records may also include creation and update provenance fields.