/query/diseaseList

  • Description

    Retrieve the list of diseases for a given source and snapshot. For each retrieved disease you get: the DISNET ID of the disease, the name, the Web link, and the list of disease codes in sources external to DISNET.

  • URL (PATH)

    /query/diseaseList?source=:source&version=:version&size=:size&page=:page&token=:token

  • Method

    GET

  • Auth required

    Optional (token)

  • Request parameters
    Parameter Description
    source *required
    [alphanumeric]
    example: source=wikipedia
    Name of the ifonrmation source
    version *required
    [alphanumeric with format “aaaa-mm-dd”]
    example: version=2018-09-15
    Date of the information source extraction, in “yyyy-mm-dd” format
    size
    [integer] by default always is 20
    example: size=25
    First parameter of the two that manage pagination; it is relative to the number of records to be displayed per page
    page
    [integer] by default always is 0
    example: page=3
    Second parameter of the two that manage pagination; it is relative to the number of the page to be displayed
    token
    [alphanumeric]
    example: token=eyJhbGciOiJI...
    Optional access key to save the current query inside the user's profile
  • Example request
                                         GET http://disnet.ctb.upm.es/api/disnet/query/diseaseList?source=wikipedia&version=2018-09-15&size=20&page=0&token=
                                    
  • Success response (application/json)
                                        {
        "content": [
            {
                "diseaseId": "DIS004692",
                "name": "17q21.31 microdeletion syndrome",
                "url": "http://en.wikipedia.org/wiki/17q21.31_microdeletion_syndrome",
                "codesCount": 2,
                "codes": [
                    {
                        "code": "17q21.31 microdeletion syndrome",
                        "typeCode": "GeneReviews"
                    },
                    {
                        "code": "610443",
                        "typeCode": "OMIM"
                    }
                ],
                "disnetConceptsCount": 0
            },
            {
                "diseaseId": "DIS007340",
                "name": "17β-Hydroxysteroid dehydrogenase III deficiency",
                "url": "http://en.wikipedia.org/wiki/17-beta-hydroxysteroid_dehydrogenase_deficiency",
                "codesCount": 3,
                "codes": [
                    {
                        "code": "264300",
                        "typeCode": "OMIM"
                    },
                    {
                        "code": "32638",
                        "typeCode": "DiseasesDB"
                    },
                    {
                        "code": "752",
                        "typeCode": "Orphanet"
                    }
                ],
                "disnetConceptsCount": 3
            },
            {
                "diseaseId": "DIS005265",
                "name": "18p-",
                "url": "http://en.wikipedia.org/wiki/18p-",
                "codesCount": 1,
                "codes": [
                    {
                        "code": "146390",
                        "typeCode": "OMIM"
                    }
                ],
                "disnetConceptsCount": 2
            },
            {
                "diseaseId": "DIS003113",
                "name": "1p36 deletion syndrome",
                "url": "http://en.wikipedia.org/wiki/1p36_deletion_syndrome",
                "codesCount": 2,
                "codes": [
                    {
                        "code": "34535",
                        "typeCode": "DiseasesDB"
                    },
                    {
                        "code": "607872",
                        "typeCode": "OMIM"
                    }
                ],
                "disnetConceptsCount": 42
            },
            {
                "diseaseId": "DIS007075",
                "name": "1q21.1 deletion syndrome",
                "url": "http://en.wikipedia.org/wiki/1q21.1_deletion_syndrome",
                "codesCount": 2,
                "codes": [
                    {
                        "code": "1q211-microdeletion",
                        "typeCode": "MedlinePlus"
                    },
                    {
                        "code": "612474",
                        "typeCode": "OMIM"
                    }
                ],
                "disnetConceptsCount": 10
            },
            {
                "diseaseId": "DIS006629",
                "name": "1q21.1 duplication syndrome",
                "url": "http://en.wikipedia.org/wiki/1q21.1_duplication_syndrome",
                "codesCount": 1,
                "codes": [
                    {
                        "code": "612475",
                        "typeCode": "OMIM"
                    }
                ],
                "disnetConceptsCount": 9
            },
            {
                "diseaseId": "DIS006819",
                "name": "2,4 Dienoyl-CoA reductase deficiency",
                "url": "http://en.wikipedia.org/wiki/2,4_Dienoyl-CoA_reductase_deficiency",
                "codesCount": 1,
                "codes": [
                    {
                        "code": "222745",
                        "typeCode": "OMIM"
                    }
                ],
                "disnetConceptsCount": 0
            },
            ...
        ],
        "token": "null", 
        "authorized": false, 
        "authorizationMessage": "null", 
        "responseCode": "200",
        "responseMessage": "OK",
        "errorsFound": [],
        "totalElements": 5862,
        "last": false,
        "totalPages": 294,
        "first": false,
        "sort": null,
        "numberOfElements": 20,
        "size": 20,
        "number": 0
    }
                                    
  • Error response (application/json)

    Common errors

    Source error

    Version error