Download OpenAPI specification:Download
TBD
Get a list of biosamples
requestedSchema | string Example: requestedSchema=ga4gh-service-info-v1.0 Schema to be used to format the |
skip | integer (Skip) >= 0 Default: 0 Example: skip=0
|
limit | integer (Limit) >= 0 Default: 10 Example: limit=10 Size of the page. Use |
filters | Array of strings Examples: filters=NCIT:C3222 filters=OBI:0100058&filters=NCIT:C4813 |
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get details about one biosample, identified by its (unique) 'id'
id required | string |
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get the genomic variants list from one biosample, identified by its (unique) 'id'
id required | string |
requestedSchema | string Example: requestedSchema=ga4gh-service-info-v1.0 Schema to be used to format the |
skip | integer (Skip) >= 0 Default: 0 Example: skip=0
|
limit | integer (Limit) >= 0 Default: 10 Example: limit=10 Size of the page. Use |
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get the analysis list from one biosample, identified by its (unique) 'id'
id required | string |
requestedSchema | string Example: requestedSchema=ga4gh-service-info-v1.0 Schema to be used to format the |
skip | integer (Skip) >= 0 Default: 0 Example: skip=0
|
limit | integer (Limit) >= 0 Default: 10 Example: limit=10 Size of the page. Use |
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get the runs list from one biosample, identified by its (unique) 'id'
id required | string |
requestedSchema | string Example: requestedSchema=ga4gh-service-info-v1.0 Schema to be used to format the |
skip | integer (Skip) >= 0 Default: 0 Example: skip=0
|
limit | integer (Limit) >= 0 Default: 10 Example: limit=10 Size of the page. Use |
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "response": {
- "$schema": "string",
- "resultSets": [
- {
- "exists": true,
- "id": "datasetA",
- "info": { },
- "results": [
- { }
], - "resultsCount": 0,
- "resultsHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "setType": "dataset"
}
]
}, - "responseSummary": {
- "exists": true,
- "numTotalResults": 123
}
}
Get a list of biosamples
$schema | string ($schema) Refers to the JSON Schema which describes the set of valid attributes for this particular document type. This attribute is mostly used in schemas that should be tested in Beacon implementations. |
required | object (beaconRequestMeta) Meta section of the Beacon request. It includes request context details relevant for the Beacon server when processing the request. |
object Parameters to limit the list of returned results. |
{- "$schema": "string",
- "meta": {
- "$schema": "string",
- "apiVersion": "v2.0",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
]
}, - "query": {
- "filters": [
- {
- "id": "HP:0002664",
- "includeDescendantTerms": true,
- "scope": "biosamples",
- "similarity": "exact"
}
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "testMode": false
}
}
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get details about one Biosample, identified by its (unique) 'id'
id required | string |
$schema | string ($schema) Refers to the JSON Schema which describes the set of valid attributes for this particular document type. This attribute is mostly used in schemas that should be tested in Beacon implementations. |
required | object (beaconRequestMeta) Meta section of the Beacon request. It includes request context details relevant for the Beacon server when processing the request. |
object Parameters to limit the list of returned results. |
{- "$schema": "string",
- "meta": {
- "$schema": "string",
- "apiVersion": "v2.0",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
]
}, - "query": {
- "filters": [
- {
- "id": "HP:0002664",
- "includeDescendantTerms": true,
- "scope": "biosamples",
- "similarity": "exact"
}
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "testMode": false
}
}
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get the genomic variants list from one biosample, identified by its (unique) 'id'
id required | string |
$schema | string ($schema) Refers to the JSON Schema which describes the set of valid attributes for this particular document type. This attribute is mostly used in schemas that should be tested in Beacon implementations. |
required | object (beaconRequestMeta) Meta section of the Beacon request. It includes request context details relevant for the Beacon server when processing the request. |
object Parameters to limit the list of returned results. |
{- "$schema": "string",
- "meta": {
- "$schema": "string",
- "apiVersion": "v2.0",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
]
}, - "query": {
- "filters": [
- {
- "id": "HP:0002664",
- "includeDescendantTerms": true,
- "scope": "biosamples",
- "similarity": "exact"
}
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "testMode": false
}
}
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get the analysis list from one biosample, identified by its (unique) 'id'
id required | string |
$schema | string ($schema) Refers to the JSON Schema which describes the set of valid attributes for this particular document type. This attribute is mostly used in schemas that should be tested in Beacon implementations. |
required | object (beaconRequestMeta) Meta section of the Beacon request. It includes request context details relevant for the Beacon server when processing the request. |
object Parameters to limit the list of returned results. |
{- "$schema": "string",
- "meta": {
- "$schema": "string",
- "apiVersion": "v2.0",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
]
}, - "query": {
- "filters": [
- {
- "id": "HP:0002664",
- "includeDescendantTerms": true,
- "scope": "biosamples",
- "similarity": "exact"
}
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "testMode": false
}
}
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "responseSummary": {
- "exists": true
}
}
Get the runs list from one biosample, identified by its (unique) 'id'
id required | string |
$schema | string ($schema) Refers to the JSON Schema which describes the set of valid attributes for this particular document type. This attribute is mostly used in schemas that should be tested in Beacon implementations. |
required | object (beaconRequestMeta) Meta section of the Beacon request. It includes request context details relevant for the Beacon server when processing the request. |
object Parameters to limit the list of returned results. |
{- "$schema": "string",
- "meta": {
- "$schema": "string",
- "apiVersion": "v2.0",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
]
}, - "query": {
- "filters": [
- {
- "id": "HP:0002664",
- "includeDescendantTerms": true,
- "scope": "biosamples",
- "similarity": "exact"
}
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "testMode": false
}
}
{- "beaconHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "info": { },
- "meta": {
- "apiVersion": "v2.0",
- "beaconId": "org.example.beacon.v2",
- "receivedRequestSummary": {
- "apiVersion": "v2.0",
- "filters": [
- "BTO:0000199",
- "PATO:0000383"
], - "includeResultsetResponses": "ALL",
- "pagination": {
- "currentPage": "ab0sc&fe1dd",
- "limit": 10,
- "nextPage": "ab0sc&fe1dd",
- "previousPage": "ab0sc&fe1dd",
- "skip": 0
}, - "requestParameters": {
- "$schema": "string",
- "property1": { },
- "property2": { }
}, - "requestedGranularity": "boolean",
- "requestedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "returnedGranularity": "boolean",
- "returnedSchemas": [
- {
- "entityType": "Individual",
- "schema": "./ga4gh-beacon-dataset-v2.0.0"
}
], - "testMode": false
}, - "response": {
- "$schema": "string",
- "resultSets": [
- {
- "exists": true,
- "id": "datasetA",
- "info": { },
- "results": [
- { }
], - "resultsCount": 0,
- "resultsHandovers": [
- {
- "handoverType": {
- "id": "ga4gh:GA.01234abcde",
- "label": "string"
}, - "note": "This handover link provides access to a summarized VCF.",
}
], - "setType": "dataset"
}
]
}, - "responseSummary": {
- "exists": true,
- "numTotalResults": 123
}
}