Search propositions with statement aggregates¶
GET https://api.moalmanac.org/search
Searches Propositions, with aggregated Statement information attached to each. Which propositions are returned is filtered the same way as /propositions (proposition_id, biomarker, biomarker_type, gene, disease, therapy, therapy_type). document, indication, and agent_id instead narrow each proposition's Statement aggregates, without changing which propositions are returned; those aggregates only count Active statements. include_empty=true also returns propositions with zero matching statements.
Parameters¶
| Name | Type | Description | Example |
|---|---|---|---|
proposition_id |
string | Return only the proposition with this id. | |
include_empty |
boolean, default false |
Also return propositions with zero matching statements. | |
biomarker |
string (repeatable) | Biomarker name, matched exactly. Repeatable; matches any of the given values (OR). | BRAF p.V600E |
biomarker_type |
string (repeatable) | Biomarker type. Repeatable; matches any of the given values (OR). | Somatic variant |
gene |
string (repeatable) | Gene symbol, matched exactly. Repeatable; matches any of the given values (OR). | BRAF |
disease |
string (repeatable) | Disease name, matched exactly. Repeatable; matches any of the given values (OR). | Melanoma |
therapy |
string (repeatable) | Therapy name, matched exactly. Repeatable; matches any of the given values (OR). | Dabrafenib |
therapy_type |
string (repeatable) | Therapy type. Repeatable; matches any of the given values (OR). | Targeted therapy |
document |
string (repeatable) | Document id. Repeatable; matches any of the given values (OR). | doc:fda:verzenio |
indication |
string (repeatable) | Indication id. Repeatable; matches any of the given values (OR). | ind:fda:verzenio:0 |
agent_id |
string (repeatable) | Agent id. Repeatable; matches any of the given values (OR). | agent:user:vanallenlab |
Example request¶
curl "https://api.moalmanac.org/search?biomarker=BRAF+p.V600E"
Response¶
Returns the standard response envelope, with data set to a list of Proposition records with aggregates.
Example response
{
"meta": {
"data_length": 1,
"message": "Search results by Proposition retrieved successfully",
"request_url": "https://api.moalmanac.org/search",
"status": "success",
"status_code": 200,
"timestamp_elapsed": 0.012345,
"timestamp_received": "2026-10-16T14:03:12.123456Z",
"timestamp_returned": "2026-10-16T14:03:12.135801Z",
"trace_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"service": {
"github": "https://github.com/vanallenlab/moalmanac-db",
"name": "Molecular Oncology Almanac",
"license": "GPL-2.0",
"release": "draft",
"url": "https://moalmanac.org",
"last_updated": "2026-10-08"
},
"data": [
{
"id": "prop:vtxr:88",
"type": "VariantTherapeuticResponseProposition",
"predicate": "predictsSensitivityTo",
"subjectVariant": {
"type": "CategoricalVariant",
"description": "Placeholder. Cat-VRS does not yet support sets of categorical variants. See the 'biomarkers' extension for biomarkers associated with this Proposition."
},
"conditionQualifier": {
"id": "dis:ncit:C3224",
"conceptType": "Disease",
"name": "Melanoma",
"mappings": [
{
"relation": "exactMatch",
"coding": {
"id": "coding:oncotree:MEL",
"code": "MEL",
"name": "Melanoma",
"system": "https://oncotree.mskcc.org",
"systemVersion": "oncotree_2025_10_03",
"iris": [
"https://oncotree.mskcc.org/?version=oncotree_2025_10_03&field=NAME&search=Melanoma+%28MEL%29"
]
}
}
],
"extensions": [
{
"name": "solid_tumor",
"value": true,
"description": "Boolean value for if this tumor type is categorized as a solid tumor."
}
],
"primaryCoding": {
"id": "coding:ncit:C3224",
"code": "C3224",
"name": "Melanoma",
"system": "https://evsexplore.semantics.cancer.gov",
"systemVersion": "26.08e",
"iris": [
"https://evsexplore.semantics.cancer.gov/evsexplore/concept/ncit/C3224"
]
}
},
"objectTherapeutic": {
"id": "tx:ncit:C82386",
"conceptType": "Therapy",
"name": "Dabrafenib",
"mappings": [
{
"relation": "relatedMatch",
"coding": {
"id": "coding:rxcui:1424911",
"code": "1424911",
"name": "dabrafenib",
"system": "RxNorm",
"systemVersion": "02-Mar-2026",
"iris": [
"https://mor.nlm.nih.gov/RxNav/search?searchBy=RXCUI&searchTerm=1424911"
]
}
},
{
"relation": "relatedMatch",
"coding": {
"id": "coding:omop:43532299",
"code": "43532299",
"name": "dabrafenib",
"system": "OMOP",
"systemVersion": "v20260227",
"iris": [
"https://athena.ohdsi.org/search-terms/terms/43532299"
]
}
}
],
"extensions": [
{
"name": "therapy_strategy",
"value": [
"B-RAF inhibition"
],
"description": "Associated therapeutic strategy or mechanism of action of the therapy."
},
{
"name": "therapy_type",
"value": "Targeted therapy",
"description": "Type of cancer treatment from cancer.gov: https://www.cancer.gov/about-cancer/treatment/types"
}
],
"primaryCoding": {
"id": "coding:ncit:C82386",
"code": "C82386",
"name": "Dabrafenib",
"system": "https://evsexplore.semantics.cancer.gov",
"systemVersion": "26.08e",
"iris": [
"https://evsexplore.semantics.cancer.gov/evsexplore/concept/ncit/C82386"
]
}
},
"extensions": [
{
"name": "biomarkers",
"value": [
{
"id": "bmkr.criterion:16",
"present": true,
"subject": {
"id": "bmkr:16",
"type": "CategoricalVariant",
"name": "BRAF p.V600E",
"constraints": [
{
"type": "DefiningAlleleConstraint",
"allele": {
"id": "ga4gh:VA.j4XnsLZcdzDIYa5pvvXM7t1wn9OITr0L",
"type": "Allele",
"name": "NP_004324.2:p.Val600Glu",
"aliases": [
"NP_004324.2:p.V600E",
"BRAF p.V600E"
],
"description": "VRS variation of NP_004324.2:p.Val600Glu",
"digest": "j4XnsLZcdzDIYa5pvvXM7t1wn9OITr0L",
"expressions": [
{
"syntax": "hgvs.p",
"value": "NP_004324.2:p.Val600Glu",
"extensions": [
{
"name": "hgvs.p_short",
"value": "p.V600E"
}
]
}
],
"location": {
"id": "ga4gh:SL.t-3DrWALhgLdXHsupI-e-M00aL3HgK3y",
"type": "SequenceLocation",
"name": null,
"aliases": [],
"description": "Amino acid position 600 of the Refseq protein NP_004324.2, which is the protein product of the MANE Select coding transcript for BRAF (refseq:NM_004333.6).",
"digest": "t-3DrWALhgLdXHsupI-e-M00aL3HgK3y",
"sequenceReference": {
"id": "ga4gh:SQ.cQvw4UsHHRRlogxbWCB8W-mKD4AraM9y",
"type": "SequenceReference",
"name": "NP_004324.2",
"aliases": [
"ensembl:ENSP00000288602.6",
"ga4gh:SQ.cQvw4UsHHRRlogxbWCB8W-mKD4AraM9y",
"refseq:NP_004324.2"
],
"description": "The protein product of the MANE Select coding transcript for BRAF (refseq:NM_004333.6), corresponding to the Refseq protein accession NP_004324.2.",
"moleculeType": "protein",
"refgetAccession": "SQ.cQvw4UsHHRRlogxbWCB8W-mKD4AraM9y",
"residueAlphabet": "aa"
},
"start": 599,
"end": 600,
"sequence": "V"
},
"state": {
"type": "LiteralSequenceExpression",
"sequence": "E"
}
},
"relations": []
},
{
"type": "FeatureContextConstraint",
"featureContext": {
"id": "gene:hgnc:1097",
"conceptType": "Gene",
"name": "BRAF",
"primaryCoding": {
"id": "coding:hgnc:1097",
"code": "HGNC:1097",
"system": "https://genenames.org",
"iris": [
"https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:1097"
]
},
"mappings": [
{
"relation": "exactMatch",
"coding": {
"id": "coding:ensembl:ensg00000157764",
"code": "ENSG00000157764",
"system": "https://www.ensembl.org",
"iris": [
"https://www.ensembl.org/id/ENSG00000157764"
]
}
},
{
"relation": "exactMatch",
"coding": {
"id": "coding:ncbi:673",
"code": "673",
"system": "https://www.ncbi.nlm.nih.gov/gene",
"iris": [
"https://www.ncbi.nlm.nih.gov/gene/673"
]
}
},
{
"relation": "relatedMatch",
"coding": {
"id": "coding:refseq:NM_004333.6",
"code": "NM_004333.6",
"system": "https://www.ncbi.nlm.nih.gov/nuccore",
"iris": [
"https://www.ncbi.nlm.nih.gov/nuccore/NM_004333.6"
]
}
}
]
}
}
],
"extensions": [
{
"name": "biomarker_type",
"value": "Somatic variant"
},
{
"name": "chromosome",
"value": "7"
},
{
"name": "start_position",
"value": 140453136
},
{
"name": "end_position",
"value": 140453136
},
{
"name": "reference_allele",
"value": "A"
},
{
"name": "alternate_allele",
"value": "T"
},
{
"name": "cdna_change",
"value": "c.1799T>A"
},
{
"name": "protein_change",
"value": "p.V600E"
},
{
"name": "variant_annotation",
"value": "Missense"
},
{
"name": "exon",
"value": 15
},
{
"name": "rsid",
"value": "rs113488022"
},
{
"name": "hgvsg",
"value": "7:g.140453136A>T"
},
{
"name": "hgvsc",
"value": "ENST00000288602.6:c.1799T>A"
}
]
}
}
],
"description": "The biomarkers associated with this Proposition, each with a `present` flag indicating if the biomarker is present (true) or absent (false). Multiple biomarkers are combined with implied AND logic."
}
],
"aggregates": {
"statement_count": 1,
"by_direction": [
{
"direction": "supports",
"count": 1
}
],
"by_document": [
{
"id": "doc:fda:tafinlar",
"count": 1
},
{
"id": "doc:fda:tafinlar:2013-05-29",
"count": 1
}
],
"by_agent": [
{
"id": "agent:org:fda",
"count": 1
}
],
"by_strength": [
{
"id": "str:ncit:C25425",
"count": 1
}
]
}
}
]
}