Jump to

• Request
• Response
• Examples

Retrieve CDS Components for a Gene Identifier and Structure Identifier

get

/ohfapi/cg/v3.3/genes/{id}/{structure}/components/CDS

This endpoint supports the retrieval of CDS Components for a Gene Row ID and Structure Row ID passed. It returns CDS Component information like Gene name, Ensembl Version, Transcript Identifier, Component Name, Component Identifier, Genomic Positions, Strand and other CDS Component associated information.

Request

Supported Media Types

• application/json
• application/xml

Path Parameters

• id: integer(int64)
  Minimum Value: 0

  gene row ID
• structure: integer(int64)
  Minimum Value: 0

  structure 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

Back to Top

Response

Supported Media Types

• application/json
• application/xml

200 Response

successful operation

Body ()

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

{
    "type":"object",
    "properties":{
        "resourceType":{
            "type":"string",
            "description":"Identify the resource type"
        },
        "items":{
            "type":"array",
            "xml":{
                "wrapped":true
            },
            "description":"A collection of paged items.",
            "items":{
                "$ref":"#/definitions/Serializable"
            }
        },
        "count":{
            "type":"integer",
            "format":"int64",
            "description":"Number of objects in the 'items' collection."
        },
        "hasMore":{
            "type":"boolean",
            "description":"A boolean indicating if more pages are available."
        },
        "links":{
            "type":"array",
            "example":"{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}",
            "xml":{
                "wrapped":true
            },
            "description":"A collection of links containing hrefs to the current, next, and previous pages as applicable.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Model for paginated collections of data."
}

Nested Schema : items

Type: array

A collection of paged items.

Show Source

• Array of: object Serializable

{
    "type":"array",
    "xml":{
        "wrapped":true
    },
    "description":"A collection of paged items.",
    "items":{
        "$ref":"#/definitions/Serializable"
    }
}

Nested Schema : links

Type: array

A collection of links containing hrefs to the current, next, and previous pages as applicable.

Show Source

• Array of: string

{
    "type":"array",
    "example":"{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}",
    "xml":{
        "wrapped":true
    },
    "description":"A collection of links containing hrefs to the current, next, and previous pages as applicable.",
    "items":{
        "type":"string"
    }
}

Example:

{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}

Nested Schema : Serializable

Type: object

400 Response

Invalid parameters supplied

404 Response

Gene CDS component(s) not found

Back to Top

Examples

The following example submits a GET request.

API URL

http://localhost:7010/ohfapi/cg/v3.3/genes/50259/225738/components/CDS

Example of Response Body

The following example shows the contents of the response body in JSON format:

{
  "resourceType": "GeneComponents",
  "items": [
    {
      "identifier": {
        "system": "ODB",
        "value": "225738"
      },
      "geneName": "ENSG00000146648",
      "ensemblVersion": "GRCH37.75",
      "componentSource": {
        "componentType": [
          {
            "componentName": "CDS",
            "componentId": 1193269,
            "genomicPosition": [
              {
                "chromosome": "7",
                "startPosition": 55086971,
                "endPosition": 55087058,
                "strand": "+",
                "numberInSequence": 1
              },
              {
                "chromosome": "7",
                "startPosition": 55209979,
                "endPosition": 55210130,
                "strand": "+",
                "numberInSequence": 2
              },
              {
                "chromosome": "7",
                "startPosition": 55210998,
                "endPosition": 55211181,
                "strand": "+",
                "numberInSequence": 3
              },
              {
                "chromosome": "7",
                "startPosition": 55214299,
                "endPosition": 55214433,
                "strand": "+",
                "numberInSequence": 4
              },
              {
                "chromosome": "7",
                "startPosition": 55218987,
                "endPosition": 55219055,
                "strand": "+",
                "numberInSequence": 5
              },
              {
                "chromosome": "7",
                "startPosition": 55220239,
                "endPosition": 55220357,
                "strand": "+",
                "numberInSequence": 6
              },
              {
                "chromosome": "7",
                "startPosition": 55221704,
                "endPosition": 55221845,
                "strand": "+",
                "numberInSequence": 7
              },
              {
                "chromosome": "7",
                "startPosition": 55223523,
                "endPosition": 55223639,
                "strand": "+",
                "numberInSequence": 8
              },
              {
                "chromosome": "7",
                "startPosition": 55224226,
                "endPosition": 55224352,
                "strand": "+",
                "numberInSequence": 9
              },
              {
                "chromosome": "7",
                "startPosition": 55224452,
                "endPosition": 55224536,
                "strand": "+",
                "numberInSequence": 10
              }
            ]
          }
        ]
      },
      "geneReference": {
        "reference": "/ohfapi/cg/v3.3/genes/50259"
      }
    }
  ],
  "count": 1,
  "hasMore": false,
  "links": [
    {
      "rel": "self",
      "href": "http://localhost:7010/ohfapi/cg/v3.3/genes/50259/225738/components/CDS"
    }
  ]
}

Back to Top