MetabolomeXchange API

In 2014 a first version of the API was released as part of MetabolomeXchange.org. This API has now been extracted from the front-end logic and is now the core feature of MetabolomeXchange on which all services are built on top on. Biggest change compared to the old API is that it runs without a database. Before a MongoDB document store was used as a persistent layer, now all are simple (cached) text files.

general

GET /stats

Retrieve stats about the publicly available datasets.

Headers

Parameters

Body

Headers

Response

HTTP 200 OK

{}

provider

GET /providers

Retrieve all providers sharing publicly available datasets.

Headers

Parameters

Body

Headers

Response

HTTP 200 OK

{}

GET /provider/{shortname}

Get all info about a single provider, including a list of the datasets of that provider.

Headers

Parameters

Name	Type	Required	Description
shortname	string	Yes	Provider shortname

Body

Headers

Response

HTTP 200 OK

{}

dataset

GET /dataset/{shortname}/{accession}

Get all info about a single dataset.

Headers

Parameters

Name	Type	Required	Description
shortname	string	Yes	Provider shortname
accession	string	Yes	Unique identifier of dataset provided by the provider

Body

Headers

Response

HTTP 200 OK

{}

GET /datasets

Retrieve all publicly available datasets by all providers.

Headers

Parameters

Body

Headers

Response

HTTP 200 OK

{}

GET /datasets/{search}

Find datasets matching $search

Headers

Parameters

Name	Type	Required	Description
search	string	Yes	$search supports the use of 'and' & 'or' syntax, including combinations /datasets/mutation&Katayonn > all datasets that match both 'mutation' and 'Katayonn'. /datasets/mutation Katayonn > all datasets that match 'mutation' and/or 'Katayonn'. /datasets/mutation\|Katayonn > all datasets that match 'mutation' and/or 'Katayonn'.

Body

Headers

Response

HTTP 200 OK

{}