Documentation for the eonum catalogue search API

Locales

Available locales are de|fr|it|en. All API calls have to prefixed with one of these locales

Search parameters

For all search calls you can provide the following parameters:
  • search - the search term
  • max_results - maximum number of search results.
  • terminal_only - Only applicable in ICD and CHOP search. Do search for terminal codes only: terminal_only=1
  • highlight - Show highlighted search terms in respective fields: highlight=1
  • simple_search - Use a simplified search with exact matching of code and description field. Empty search terms are also allowed. Order is not based on ranking but on alphabetical order of codes.
  • skip_sort_by_code - If skip_sort_by_code=1, the search results are not sorted by code, i.e. the results are sorted by relevance.
Only applicable for certain search calls:
  • date (in the DD.MM.YYYY format) - Only applicable in MiGeL and AL. Yields results active at provided date. If date not specified, only active codes are returned.
  • authorized - Only applicable for Drugs. Default search for authorized drugs. If set to authorized=0, search yields result for all Drugs.
For all code view calls (DRG, ADRG, MDC, Partition, ICD, CHOP, CHOP chapter, ICD chapter, ICD group, MiGeL, AL, Drugs) you can provide the following parameters:
  • show_detail - if set to '1' the requested code is shown with all details including children and parent codes with links.
Only applicable for certain code view calls:
  • date (in the DD.MM.YYYY format) - Only applicable in MiGeL and AL. Yields results active at provided date. If date not specified, only active codes are returned.
  • authorized - Only applicable for Drugs. Default search for authorized drugs. If set to authorized=0, search yields result for all Drugs.
All objects obtained by a code call or in a parent or children field of a detailed code call have at least the fields: code, text, url

DRGs - Diagnosis Related Groups (SwissDRG)

scope: '/:locale/drgs' Versions are in the format [0-z.\-]+, codes are in the format [0-z]+, usually 4 characters

GET /:locale/drgs/versions Get a list of all valid DRG versions as a JSON array of strings.

Sample call: /de/drgs/versions
Example: Populate a dropdown using AJAX

GET /:locale/drgs/:version/:code Get one DRG by its code and version as a JSON object

Sample call: /de/drgs/V3.0/P67A

GET /:locale/mdcs/:version/:code Get one MDC by its code and version as a JSON object

Sample call: /de/mdcs/V3.0/02

GET /:locale/partitions/:version/:code Get one Partition by its code and version as a JSON object

Sample call: /de/partitions/V3.0/B_M

GET /:locale/drgs/:version/search Search for DRGs by code, description text or relevant codes. Retrieve results as a JSON array.

Sample call: /de/drgs/V3.0/search?max_results=2&search=Magen
Result:

ADRGs / Base DRGs (SwissDRG)

scope: '/:locale/adrgs' Versions are identical to the DRG versions, codes are in the format [0-z]+, usually 3 characters

GET /:locale/adrgs/:version/:code Get one ADRG by its code and version as a JSON object.

Sample call: /de/adrgs/V3.0/P67

GET /:locale/adrgs/:version/search Search for ADRGs by code, description text or relevant codes (ICD or CHOP). Retrieve results as a JSON array.

Sample call: /de/adrgs/V3.0/search?max_results=2&search=Magen
Result:

Supplements / Zusatzentgelte (SwissDRG)

scope: '/:locale/supplements' Versions are identical to the DRG versions. However not all old DRG versions (< 6.0) have supplements. Codes are in the format ZE-[0-9]{4}-[0-9]+(\.[0-9]+)?

GET /:locale/supplements/versions Get a list of all valid supplement versions as a JSON array of strings.

Sample call: /de/supplements/versions
Example: Populate a dropdown using AJAX

GET /:locale/supplements/:version/:code Get one supplement by its code and version as a JSON object.

Sample call: /de/supplements/V8.0/ZE-2019-24.11

GET /:locale/supplement/:version/search Search for supplement by code or description text. Retrieve results as a JSON array.

Sample call: /de/supplements/V8.0/search?max_results=2&search=Magen
Result:

CHOPs (Swiss Surgery Classification)

scope: '/:locale/chops' Versions are in the format CHOP_[0-9]+, codes are in the format [0-z.\-]+

GET /:locale/chops/versions Get a list of all valid CHOP versions as a JSON array of strings.

Sample call: /de/chops/versions

GET /:locale/chops/:version/:code Get one CHOP code by its code and version as a JSON object.

Sample call: /de/chops/CHOP_2014/39.49

GET /:locale/chops/:version/search Search for CHOP codes by code, description text or inclusions. Retrieve results as a JSON array.

Sample call: /de/chops/CHOP_2014/search?max_results=2&search=Magen
Result:

GET /:locale/chop_chapters/:version/:code Get one CHOP chapter by its code and version as a JSON object.

Sample call: /de/chop_chapters/CHOP_2014/C3

ICDs (International Classification of Diseases. Mostly the German Modifications)

scope: '/:locale/icds' Codes are in the format [0-z.\-]+

GET /:locale/icds/versions Get a list of all valid ICD versions as a JSON array of strings.

Sample call: /de/icds/versions

GET /:locale/icds/:version/:code Get one ICD code by its code and version as a JSON object.

Sample call: /de/icds/ICD10-GM-2014/T817

GET /:locale/icds/:version/search Search for ICD codes by code, description text, inclusions or synonyms. Retrieve results as a JSON array.

Sample call: /de/icds/ICD10-GM-2014/search?max_results=2&search=Magen
Result:

GET /:locale/icd_groups/:version/:code Get one ICD group by its code and version as a JSON object.

Sample call: /de/icd_groups/ICD10-GM-2014/A00-A09

GET /:locale/icd_chapters/:version/:code Get one ICD chapter by its code and version as a JSON object.

Sample call: /de/icd_chapters/ICD10-GM-2014/II

TARDOCs

scope: '/:locale/tardocs' Versions are in the format TARDOC_[0-9]\.[0-9]\.[0-9], codes are in the format [A-Z]{2}\.([0-9]{1,2}|[0-9]{2}\.[0-9]{0,4})?

GET /:locale/tardocs/versions Get a list of all valid TARDOC versions as a JSON array of strings.

Sample call: /de/tardocs/versions

GET /:locale/tardocs/:version/:code Get one TARDOC code by its code and version as a JSON object.

Sample call: /de/tardocs/TARDOC_1.3.2/VE.05.0260

GET /:locale/tardocs/:version/search Search for TARDOC codes by code, description text, inclusions or synonyms. Retrieve results as a JSON array.

Sample call: /de/tardocs/TARDOC_1.3.2/search?max_results=2&search=Magen
Result:

GET /:locale/tardoc_chapters/:version/:code Get one TARDOC chapter by its code and version as a JSON object.

Sample call: /de/tardoc_chapters/TARDOC_1.3.2/K

GET /:locale/tardoc_groups/:version/:code Get one TARDOC group by its code and version as a JSON object.

Sample call: /de/tardoc_groups/TARDOC_1.3.2/401

TARMEDs (Tarif Médical)

scope: '/:locale/tarmeds' Versions are in the format TARMED_[0-9]{2}\.[0-9]{2}, codes are in the format [0-9.]{2,11}

GET /:locale/tarmeds/versions Get a list of all valid TARMED versions as a JSON array of strings.

Sample call: /de/tarmeds/versions

GET /:locale/tarmeds/:version/:code Get one TARMED code by its code and version as a JSON object.

Sample call: /de/tarmeds/TARMED_01.09/05.0910

GET /:locale/tarmeds/:version/search Search for TARMED codes by code, description text, inclusions or synonyms. Retrieve results as a JSON array.

Sample call: /de/tarmeds/TARMED_01.09/search?max_results=2&search=Magen
Result:

GET /:locale/tarmed_chapters/:version/:code Get one TARMED chapter by its code and version as a JSON object.

Sample call: /de/tarmed_chapters/TARMED_01.09/05

GET /:locale/tarmed_groups/:version/:code Get one TARMED group by its code and version as a JSON object.

Sample call: /de/tarmed_groups/TARMED_01.09/05

GET /:locale/tarmed_blocks/:version/:code Get one TARMED block by its code and version as a JSON object.

Sample call: /de/tarmed_blocks/TARMED_01.09/05

MiGeLs (Mittel- und Gegenständeliste)

scope: '/:locale/migels' Version is in the format MIGEL (we do not distinguish different versions but keep track of code changes via active flag), codes are in the format [0-z.]+

GET /:locale/migels/:version/:code Get one MiGeL code by its code and version as a JSON object.

Sample call: /de/migels/MIGEL/01.01.01.00.1
Sample call specifying date (returns code valid at this date, use show_detail=1 to list all attributes): /de/migels/MIGEL/01.01.01.00.1?date=11.12.2023&show_detail=1

GET /:locale/migels/:version/:code/all Get all MiGeL (active and inactive) by its code and version as a JSON object.

Sample call: /de/migels/MIGEL/01.01.01.00.1/all

GET /:locale/migels/:version/search Search for MiGeL codes by code, title or description text. Retrieve results as a JSON array.

Sample call: /de/migels/MIGEL/search?max_results=2&search=absaug
Sample call specifying date (returns search results for codes valid at this date): /de/migels/MIGEL/search?date=11.12.2023&max_results=2&search=absaug
Result:

Drugs (from SAI-Refdatabase)

scope: '/:locale/drugs' Version is in the format DRUG (we do not distinguish different versions), codes are in the format [0-9]{13}

GET /:locale/drugs/:version/:code Get one Drug code by its code and version as a JSON object.

Sample call: /de/drugs/DRUG/7680517950406

GET /:locale/drugs/:version/search Search for Drug codes by code, title, description text, substance name, field of application, ... Retrieve results as a JSON array.

Sample call: /de/drugs/DRUG/search?max_results=2&search=aspir
Result:

Laboratory Analyses (from Analyseliste (AL))

scope: '/:locale/laboratory_analyses' Version is in the format AL (we do not distinguish different versions but keep track of code changes via active flag), codes are in the format /[0-9]{4}\.?[0-9]{2}/ (Pos.-Nr.) or /[A-D]{1}[0-9]?\.?[0-9]?/i (chapters).

GET /:locale/laboratory_analyses/:version/:code Get one AL code by its code and version as a JSON object.

Sample call: /de/laboratory_analyses/AL/6603.54
Sample call specifying date (returns code valid at this date, also use show_detail=1 to list all attributes): /de/laboratory_analyses/AL/6603.54?date=19.12.2023&show_detail=1

GET /:locale/laboratory_analyses/:version/:code/all Get all AL codes (active and inactive) by its code and version as a JSON object.

Sample call: /de/laboratory_analyses/AL/6603.54/all

GET /:locale/laboratory_analyses/:version/search Search for AL codes by code, title, description text, limitation, comment or faculty. Retrieve results as a JSON array.

Sample call: /de/laboratory_analyses/AL/search?max_results=2&search=glukose
Sample call specifying date (returns search results for codes valid at this date): /de/laboratory_analyses/AL/search?date=19.12.2023&max_results=2&search=glukose
Result:

Ambulant Groups (STS)

scope: '/:locale/amb_groups' Versions are in the format [0-z.\-]+, codes are in the format C[0-9]{2}.[0-z]{3}.

GET /:locale/amb_groups/versions Get a list of all valid ambulant group versions as a JSON array of strings.

Sample call: /de/amb_groups/versions
Example: Populate a dropdown using AJAX

GET /:locale/amb_groups/:version/:code Get one ambulant group by its code and version as a JSON object

Sample call: /de/amb_groups/V1.0/C11.30Z

GET /:locale/capitula/:version/:code Get one capitulum by its code and version as a JSON object. Non numerical capitulums are given by "PRE", "99A" and "99B".

Sample call: /de/capitula/V1.0/02

GET /:locale/amb_groups/:version/search Search for amb group codes by code or text. Retrieve results as a JSON array.

Sample call: /de/amb_groups/V1.0/search?max_results=2&search=Katarakt
Result:

Tariff 003 - Tarmedpauschalen neu

scope: '/:locale/tariff003_codes' Versions are in the format [0-z.\-]+, codes are in the format

GET /:locale/tariff003_codes/versions Get a list of all valid tariff 003 versions as a JSON array of strings.

Sample call: /de/tariff003_codes/versions
Example: Populate a dropdown using AJAX

GET /:locale/tariff003_codes/:version/:code Get one tariff 003 code by its code and version as a JSON object.

Sample call: /de/tariff003_codes/1.47/00.0050.00.07

GET /:locale/tariff003_chapters/:version/:code Get one tariff 003 chapter by its code and version as a JSON object.

Sample call: /de/tariff003_chapters/1.47/00

GET /:locale/tariff003_codes/:version/search Search for tariff 003 codes by code or text. Retrieve results as a JSON array.

Sample call: /de/tariff003_codes/1.47/search?max_results=2&search=katarakt
Result:

RCGs - Rehabilitative Cost Groups (ST Reha)

scope: '/:locale/rcgs' Versions are in the format REHA_[0-z.]+, codes are in the format TR[0-9]{2}[A-Z]{1}.

GET /:locale/rcgs/versions Get a list of all valid RCG versions as a JSON array of strings.

Sample call: /de/rcgs/versions
Example: Populate a dropdown using AJAX

GET /:locale/rcgs/:version/:code Get one RCG by its code and version as a JSON object

Sample call: /de/rcgs/REHA_2.0/TR14C

GET /:locale/rcgs/:version/search Search for RCGs by code or text. Retrieve results as a JSON array.

Sample call: /de/rcgs/REHA_2.0/search?max_results=2&search=skelettal
Result:

ARCGs / Base RCGs (ST Reha)

scope: '/:locale/arcgs' Versions are identical to the RCG versions, codes are in the format TR[0-9]{2}.

GET /:locale/arcgs/:version/:code Get one ARCG by its code and version as a JSON object.

Sample call: /de/arcgs/REHA_2.0/TR13

GET /:locale/arcgs/:version/search Search for ARCGs by code or text . Retrieve results as a JSON array.

Sample call: /de/arcgs/REHA_2.0/search?max_results=2&search=kardial
Result: