/pheno/disnet-diseases?name={name}

  • Description

    Retrieve a list of diseases by name, and optionally filter by source and snapshot. You can search the name by exact match or not.

  • URL (PATH)

    /pheno/disnet-diseases?name={name}&source={source}&snapshot={snapshot}&exact-match={exact-match}&token={token}

  • Method

    GET

  • Authentication

    Optional (token)

  • Request parameters & Path variables
    Parameter Description
    name
    [alphanumeric]
    required     		Input name to search by
    source
    [alphanumeric]
    optional
    always paired with snapshot         		Name of the information source
    snapshot
    [alphanumeric]
    optional
    always paired with source         		Date of the information extraction, with the the following format: “yyyy-mm-dd”
    exact-match
    [boolean] true by default
    optional     		If true it searches an exact name match, if false it finds all diseases containing the string in the parameter 'name'
    token
    [alphanumeric]
    optional     		Optional access key to save the current query in your profile
  • Example request
                                         https://disnet.ctb.upm.es/api/disnet/pheno/disnet-diseases?source=wikipedia&snapshot=2020-01-01&name=depression&exact-match=false&token=eJtdWrIisOiJt...
  • Success response (application/json)
                                        {
  "token": null,
  "authorized": false,
  "authorizationMessage": null,
  "responseCode": "200",
  "responseMessage": "OK",
  "errorsFound": [],
  "data": [
    {
      "name": "Postpartum depression",
      "diseaseId": "DIS003379"
    },
    {
      "name": "Atypical depression",
      "diseaseId": "DIS004231"
    },
    {
      "name": "Treatment-resistant depression",
      "diseaseId": "DIS007713"
    },
    ...
  ]
}
  • Error response (application/json)

    Common errors

    Source error

    Snapshot error

    Snapshot format error