Skip to content

Usage Overview

IOMED APIs are REST APIs. All the resources HTTP protocol and trying to adhere to the basic REST principles.

The resources employ HTTP methods (mainly GET, POST) in a standardized way and the responses are all done in JSON format. The available endpoints at this moment are listed below.

Warning

In our cloud version, all the resources are reachable ONLY through HTTPS

API usage

The minimal usage of the API is very simple, just POST a json including the text you want to parse.

Hint

You can try even more easily using the iomed python library:

pip3 install iomed
Example of request
curl -X POST https://api.iomed.es/tagger/annotation \
     -H 'apikey: <YOUR-API-KEY-HERE>' \
     -d '{"text": "fractura en la cadera"}'
# by default sends requests to https://api.iomed.es/tagger
iomed -k <YOUR-API-KEY-HERE> "fractura en la cadera"
import requests
import json
headers = {
  'apikey': 'your-api-key'
}
data = {
  'text': 'fractura en la cadera'
}
response = requests.post('https://api.iomed.es/tagger/annotation', data=data, headers=headers)
content = json.loads(response.content)
version = content['version']
medical_concepts = content['annotations']
from iomed import MEL
mel = MEL(apikey='your-api-key')
medical_concepts = mel.parse('fractura en la cadera')

and you will get back a json. In order to understand this json, please visit the section Annotation Structure.

Example of response
{
  "annotations": [
    {
      "code": {
        "umls": "C0016658",
        "snomed_ct": [
          "72704001",
          "125605004"
        ],
        "icd9_cm": [
          "829",
          "E887",
          "800-829.99"
        ],
        "icd10_cm": [
          "T14.8"
        ],
        "loinc": [
          "LP128687-3",
          "LA7437-2",
          "MTHU040623"
        ]
      },
      "type": {
        "umls": "Injury or Poisoning",
        "iomed": "Finding"
      },
      "match": {
        "begin": 0,
        "end": 8,
        "text": "fractura",
        "found_as": "fractura",
        "preferred_term": "fractura de hueso"
      },
      "characteristics": {},
      "id": 0
    },
    {
      "code": {
        "umls": "C0019552",
        "snomed_ct": [
          "29836001",
          "304907005",
          "24136001"
        ],
        "loinc": [
          "LP7348-8",
          "LA3973-0",
          "LP199979-8",
          "LP207492-2",
          "MTHU002686"
        ]
      },
      "type": {
        "umls": "Body Part, Organ, or Organ Component",
        "iomed": "Anatomy"
      },
      "match": {
        "begin": 15,
        "end": 21,
        "text": "cadera",
        "found_as": "cadera",
        "preferred_term": "Caderas"
      },
      "characteristics": {},
      "id": 1,
      "head": 0
    }
  ],
  "relations": [
    {
      "from": 0,
      "to": 1,
      "rel": "has_anatomical_location",
    }
  ],
  "version": "v0.9.0-rc1"
}