Retrieve Genes for a Geneset Identifier
get
/ohfapi/cg/v3.3/genes/byGeneSet/{id}/{alignmentId}
This endpoint supports the retrieval of Genes for a single Geneset Row ID and Assembly/Alignment Row ID passed. It returns Gene information like Gene Name, HUGO Name, Assembly/Alignment, Chromosome and other Gene related information.
Request
Supported Media Types
- application/json
- application/xml
Path Parameters
-
alignmentId: integer(int64)
Minimum Value:
0
Alignment row ID -
id: integer(int64)
Minimum Value:
0
Geneset row ID
Query Parameters
-
limit(optional): integer(int32)
Number of rows to return
-
offset(optional): integer(int32)
Row number to start from
Security
-
basicAuth: basic
Type:
basic
Response
Supported Media Types
- application/json
- application/xml
200 Response
successful operation
Root Schema : PageableCollection
Type:
object
Model for paginated collections of data.
Show Source
-
count(optional):
integer(int64)
Number of objects in the 'items' collection.
-
hasMore(optional):
boolean
A boolean indicating if more pages are available.
-
items(optional):
array items
A collection of paged items.
-
links(optional):
array links
A collection of links containing hrefs to the current, next, and previous pages as applicable.
-
resourceType(optional):
string
Identify the resource type
Nested Schema : links
Type:
array
A collection of links containing hrefs to the current, next, and previous pages as applicable.
Show Source
Example:
{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}
Nested Schema : Serializable
Type:
object
400 Response
Invalid parameters supplied
404 Response
Genes(s) not found
Examples
The following example submits a GET request.
API URL
http://localhost:7010/ohfapi/cg/v3.3/genes/byGeneSet/12/1
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "resourceType": "Genes", "items": [ { "identifier": { "system": "ODB", "value": "2" }, "geneName": "ENSG00000223972", "hugoName": "DDX11L1", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/2" } }, { "identifier": { "system": "ODB", "value": "3" }, "geneName": "ENSG00000227232", "hugoName": "WASH7P", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/3" } }, { "identifier": { "system": "ODB", "value": "4" }, "geneName": "ENSG00000243485", "hugoName": "MIR1302-10", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/4" } }, { "identifier": { "system": "ODB", "value": "5" }, "geneName": "ENSG00000237613", "hugoName": "FAM138A", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/5" } }, { "identifier": { "system": "ODB", "value": "6" }, "geneName": "ENSG00000268020", "hugoName": "OR4G4P", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/6" } }, { "identifier": { "system": "ODB", "value": "7" }, "geneName": "ENSG00000240361", "hugoName": "OR4G11P", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/7" } }, { "identifier": { "system": "ODB", "value": "8" }, "geneName": "ENSG00000186092", "hugoName": "OR4F5", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/8" } }, { "identifier": { "system": "ODB", "value": "9" }, "geneName": "ENSG00000238009", "hugoName": "RP11-34P13.7", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/9" } }, { "identifier": { "system": "ODB", "value": "10" }, "geneName": "ENSG00000239945", "hugoName": "RP11-34P13.8", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/10" } }, { "identifier": { "system": "ODB", "value": "11" }, "geneName": "ENSG00000233750", "hugoName": "CICP27", "assembly": "GRCh37", "chromosome": "1", "geneReference": { "reference": "/ohfapi/cg/v3.3/genes/11" } } ], "count": 10, "hasMore": false, "links": [ { "rel": "self", "href": "http://localhost:7010/ohfapi/cg/v3.3/genes/byGeneSet/12/1" } ] }