/pheno/symptoms?name={name}

  • Description

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

  • URL (PATH)

    /pheno/symptoms?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/symptoms?name=pain&exact-match=false&source=wikipedia&snapshot=2020-01-01&token=eJtdWrIisOiJt...
                                    
  • Success response (application/json)
                                        {
      "token": null,
      "authorized": false,
      "authorizationMessage": null,
      "responseCode": "200",
      "responseMessage": "OK",
      "errorsFound": [],
      "data": [
        {
          "name": "Abdominal pain",
          "cui": "C0000737",
          "semanticTypes": [
            "sosy"
          ]
        },
        {
          "name": "Congenital indifference to pain",
          "cui": "C0002768",
          "semanticTypes": [
            "cgab"
          ]
        }
       ...  ]
    }
                                    
  • Error response (application/json)

    Common errors

    Source error

    Snapshot error

    Snapshot format error