Retrieve Variant Cancers for a Variant Identifier
get
/ohfapi/cg/v3.3/variants/{id}/cancer
This endpoint supports the retrieval of Variant Cancers for a Variant Identifier. It retuns Variant Cancer information like HUGO Name, Transcript Identifier, Assembly/Alignment Name, Ensembl Version, Amino Acid Change and other Variant Cancer associated information.
Request
Supported Media Types
- application/json
- application/xml
Path Parameters
-
id: integer(int64)
Variant Row ID
Security
-
basicAuth: basic
Type:
basic
Response
Supported Media Types
- application/json
- application/xml
200 Response
successful operation
Root Schema : VariantCancers
Type:
Show Source
object
-
cancerVariant(optional):
array cancerVariant
List of Variant Cancers
-
identifier(optional):
object Identifier
Identifier assigned by a given system
-
resourceType(optional):
string
-
variantReferences(optional):
object LinkedReference
Nested Schema : Identifier
Type:
object
Identifier assigned by a given system
Show Source
-
system(optional):
string
System which assigned this identifier
-
value(optional):
string
Identifier value
Nested Schema : VariantCancer
Type:
Show Source
object
-
accession(optional):
string
Accession Name
-
anatomicalSubtype(optional):
string
Anatomical Subtype
-
assembly(optional):
string
Assembly/Alignment Name. For ex.,GRCh38
-
coding(optional):
string
Mutation in Coding Sequence Flag
-
curationSource(optional):
string
Curation Source Name
-
gwScreen(optional):
string
Sample Genome Wide Screen Flag
-
hgncId(optional):
string
HUGO Gene Nomenclature Reference ID
-
histologySubtype(optional):
string
Histology Subtype Name
-
hugoName(optional):
string
Approved HUGO symbol for species loci, including protein coding genes, RNA genes and pseudogenes, e.g. 'SRY', 'DMRT1', 'FOXL2', etc.
-
mutationSomaticStatus(optional):
string
Somatic Mutation Status
-
primaryHistology(optional):
string
Anatomical Primary Site Name
-
referenceID(optional):
string
Cosmic Mutation ID
-
siteSubType(optional):
string
Site Subtype
-
version(optional):
string
Version Label. For ex.,SIFT_VER2_75
-
zygosity(optional):
string
Zygosity of Mutation
400 Response
Variant Id is not supplied
Examples
The following example submits a GET request.
API URL
http://localhost:7010/ohfapi/cg/v3.3/variants/7678/cancer
Example of Response Body
The following example shows the response returned in JSON format.
{ "resourceType" : "CancerVariants", "identifier" : { "system" : "ODB", "value" : "7678" }, "cancerVariant" : [ { "primaryHistology" : "carcinoma", "histologySubtype" : "adenocarcinoma", "siteSubType" : "large_intestine", "anatomicalSubtype" : "colon", "hugoName" : "SAMD11", "accession" : "ENST00000342066", "hgncId" : "28706", "mutationSomaticStatus" : "Variant of unknown origin", "referenceID" : "COSM1344644", "zygosity" : "het", "gwScreen" : "y", "coding" : "Y", "curationSource" : "COSMIC", "version" : "COSMIC.V67", "assembly" : "GRCh37" }, { "primaryHistology" : "carcinoma", "histologySubtype" : "NS", "siteSubType" : "liver", "anatomicalSubtype" : "NS", "hugoName" : "SAMD11", "accession" : "ENST00000342066", "hgncId" : "28706", "mutationSomaticStatus" : "Variant of unknown origin", "referenceID" : "COSM1344644", "zygosity" : "het", "gwScreen" : "y", "coding" : "Y", "curationSource" : "COSMIC", "version" : "COSMIC.V67", "assembly" : "GRCh37" } ], "variantReferences" : { "reference" : "/ohfapi/cg/v3.3/variants/7678" } }