This endpoint is for searching the linearization (such as MMS). The search can be customized using the parameters as described
Search endpoint accepts both GET and POST requests. If the size of the request is too large, you may need to use POST as HTTP
POST {{baseUrl}}/icd/release/11/:releaseId/:linearizationname/search?q=sed velit minim dolore&subtreesFilter=eu&includeKeywordResult=false&chapterFilter=veniam laboris&useFlexisearch=false&flatResults=true&propertiesToBeSearched=ut id ipsum sint
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
q | string | Text to be searched. Having the character % at the end will be regarded as a wild card for that word | |
subtreesFilter | string | Optional parameter. Comma separated list of URIs. If provided, the search will be performed on the entities provided and their descendants | |
includeKeywordResult | boolean | Optional parameter. Default false. |
If set to true, the search result will also include keyword list
- if the last word provided is incomplete, keyword list includes all words that start with the incomplete word (word completion mode)
- if the last word is complete, the keyword list will provide suggested additional words that could be added to the search query. (word suggestion mode)
The behavior can be seen in the 1st column of the ICD-11 Coding Tool search results |
| chapterFilter
| string | | Optional, comma or semicolon separated list of chapter codes eg:01;02;21 When provided, the search will be performed only on these chapters |
| useFlexisearch
| boolean | | Changes the search mode to flexible search.
- In the regular search mode, the Coding Tool will only give you results that contain all of the words that you've used in your search. It accepts different variants or
synonyms of the words but essentially it searches for a result that contains all components of your search. Whereas in flexible search mode, the results do not have to
contain all of the words that are typed. It would still try to find the best matching phrase but there may be words in your search that are not matched at all
- It is recommended to use flexible search only when regular search does not provide a result |
| flatResults
| boolean | | Optional parameter. Default value false. If set to true the search result entities are provided in a nested data structure
representing the ICD-11 hierarchy. Otherwise they are listed as flat list of matches |
| propertiesToBeSearched
| string | | Optional. When not provided, the search is performed on the "IndexTerm" property only. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
API-Version | string | (Required) Version of the API. Values are like v1,v2. | |
For example, if you provide value v2, the API will respond in the format of the version 2 of the API | |||
Accept-Language | string | (Required) ICD-API is multi-lingual. By changing this header, you may make the API respond in different languages | |
Languages will be available as the translations of ICD-11 completes. | |||
The values are language codes such as en, es, zh, etc. |
RESPONSES
status: OK
{"destinationEntities":[{"id":"http://id.who.int/icd/release/11/2018-12/mms/983550510","title":"\u003cem class='found'\u003eRespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e, confirmed","propertiesTruncated":false,"isResidualOther":false,"isResidualUnspecified":false,"chapter":"01","theCode":"1B10.0","score":0.013513304,"titleIsASearchResult":true,"titleIsTopScore":true,"entityType":0,"important":false,"descendants":[],"stemId":"http://id.who.int/icd/release/11/2018-12/mms/983550510","isLeaf":true,"matchingPVs":[{"propertyId":"IndexTerm","label":"\u003cem class='found'\u003eRespiratory\u003c/em\u003e TB - [\u003cem class='found'\u003etuberculosis\u003c/em\u003e]","score":0.00010557269,"important":false},{"propertyId":"IndexTerm","label":"\u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e, with bacteriological and histological confirmation","score":1.8048e-07,"important":false},{"propertyId":"IndexTerm","label":"Primary \u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e, confirmed bacteriologically or histologically","score":7.556804e-11,"important":false},{"propertyId":"IndexTerm","label":"primary \u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculous\u003c/em\u003e with bacteriological and histological confirmation","score":7.556804e-11,"important":false}]},{"id":"http://id.who.int/icd/release/11/2018-12/mms/1311939281","title":"\u003cem class='found'\u003eRespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e, not confirmed","propertiesTruncated":false,"isResidualOther":false,"isResidualUnspecified":false,"chapter":"01","theCode":"1B10.1","score":0.013513304,"titleIsASearchResult":true,"titleIsTopScore":false,"entityType":0,"important":false,"descendants":[],"stemId":"http://id.who.int/icd/release/11/2018-12/mms/1311939281","isLeaf":true,"matchingPVs":[{"propertyId":"IndexTerm","label":"primary \u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e","score":0.013513304,"important":false},{"propertyId":"IndexTerm","label":"Primary \u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e NOS","score":0.013513304,"important":false},{"propertyId":"IndexTerm","label":"Primary \u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e without mention of bacteriological or histological confirmation","score":2.3473455e-19,"important":false}]},{"id":"http://id.who.int/icd/release/11/2018-12/mms/882244568/unspecified","title":"\u003cem class='found'\u003eRespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e, without mention of bacteriological or histological confirmation","propertiesTruncated":false,"isResidualOther":false,"isResidualUnspecified":true,"chapter":"01","theCode":"1B10.Z","score":0.5402892,"titleIsASearchResult":true,"titleIsTopScore":false,"entityType":0,"important":false,"descendants":[],"stemId":"http://id.who.int/icd/release/11/2018-12/mms/882244568/unspecified","isLeaf":true,"matchingPVs":[{"propertyId":"IndexTerm","label":"\u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e","score":0.5402892,"important":true},{"propertyId":"IndexTerm","label":"\u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e NOS","score":0.5402892,"important":false},{"propertyId":"IndexTerm","label":"\u003cem class='found'\u003eTuberculosis\u003c/em\u003e of the \u003cem class='found'\u003erespiratory\u003c/em\u003e system","score":0.013513304,"important":false},{"propertyId":"IndexTerm","label":"\u003cem class='found'\u003etuberculosis\u003c/em\u003e of \u003cem class='found'\u003erespiratory\u003c/em\u003e tract","score":0.013513304,"important":false}]},{"id":"http://id.who.int/icd/release/11/2018-12/mms/1968623900","title":"Sequelae of tuberculosis","propertiesTruncated":false,"isResidualOther":false,"isResidualUnspecified":false,"chapter":"01","theCode":"1G80","score":0.013513304,"titleIsASearchResult":false,"titleIsTopScore":false,"entityType":0,"important":false,"descendants":[],"stemId":"http://id.who.int/icd/release/11/2018-12/mms/1968623900","isLeaf":true,"matchingPVs":[{"propertyId":"IndexTerm","label":"Sequelae of \u003cem class='found'\u003erespiratory\u003c/em\u003e or unspecified \u003cem class='found'\u003etuberculosis\u003c/em\u003e","score":0.013513304,"important":false},{"propertyId":"IndexTerm","label":"Late effect of \u003cem class='found'\u003erespiratory\u003c/em\u003e or unspecified \u003cem class='found'\u003etuberculosis\u003c/em\u003e","score":0.00010557269,"important":false}]},{"id":"http://id.who.int/icd/release/11/2018-12/mms/534466036","title":"Special screening examination for \u003cem class='found'\u003erespiratory\u003c/em\u003e \u003cem class='found'\u003etuberculosis\u003c/em\u003e","propertiesTruncated":false,"isResidualOther":false,"isResidualUnspecified":false,"chapter":"24","theCode":"QA08.1","score":1.8048e-07,"titleIsASearchResult":true,"titleIsTopScore":true,"entityType":0,"important":false,"descendants":[],"stemId":"http://id.who.int/icd/release/11/2018-12/mms/534466036","isLeaf":true,"matchingPVs":[]}],"error":false,"errorMessage":null,"resultChopped":false,"wordSuggestionsChopped":false,"guessType":1,"uniqueSearchId":"8db16902-72e5-491d-876d-1cbe369e8c28","words":null}