×

Note : All parameters except 'term' are case sensitive.

PARAMETER DESCRIPTION
term Term/text or Concept ID to be searched in SNOMED CT repository.
Example- fever, 22298006
id SNOMED CT Concept Identifier.
Example- 22298006
state State of a component.

Possible values - active, inactive, both.

  • active - It will return only active Components.
  • inactive - It will return only inactive Components.
  • both - It will return both active and inactive Components.
Default Value - both
semantictag The Semantic Tag in which SNOMED CT term/text or concept id will be searched. Refer to this article for more information.

One or more Semantic Tag can be given with ++ separator.

Possible values - all, procedure, disorder, finding, observable entity, body structure, organism, substance, specimen, physical force, event, environment / location, situation , qualifier value, record artifact, life style, regime/therapy and all possible values

Default Value - all
acceptability Represents the type of description i.e. whether the search results contains preferred terms or preferred terms other than FSN, only acceptable terms or synonyms.

Possible values - preferred, preferredexcludingfsn, synonyms, acceptable, all.
If acceptability is,

  • preferred - refers to all preferred description for a concept (including FSN).
  • preferredexcludingfsn - refers to SNOMEDCT description for preferred terms excluding FSN.
  • synonyms - refers to all description for a concept (excluding FSN).
  • acceptable- refers to all description for a concept excluding preferred.
  • all - refers to all description for a concept (both preferred and acceptable).
Default Value - all
returnlimit Maximum number of matching terms to be fetched.
For all results returnlimit is -1.
Example - 100
returnAll Boolean value, if true, returns all the concepts. If false, returns first 100 concepts.
Default value : false.
groupbyconcept Boolean value, if true, then method will return set of CompositeDescription which will contain one description from one concept.
The default value is false, which will return all matching descriptions. Any value other than 'true' and 'false' will internally be considered as 'false'.
refsetid Refset Identifier.
For Search through whole SNOMED CT terminology refsetid is null
For Search through specific Refset refsetid should be a numeric value
Example - 721144007
parentid Parent Concept Identifier

One or more Parent Id can be given with ++ separator.


For Search through whole SNOMED CT terminology parentid is null
For Search through all descendants of a specific Concept parentid should be a numeric value
Example - 27624003
fullconcept Boolean value, if true, then method will return set of CompositeDescription which contains full concept details object. if false, then method returns set of CompositeDescription which contains only conceptId, term, id (descriptionId), FSN of concept.
The default value is true, which will return all concept detail. Any value other than 'true' and 'false' will internally be considered as 'true'.
excludeparentconcept Boolean value, if true, then method will return set of CompositeDescription which will not contain descriptions from given parent id.
The default value is false, which will contain descriptions from given parent id. Any value other than 'true' and 'false' will internally be considered as 'false'.
langrefset Specifies English language reference set for US or UK.

Possible values - us, uk, hi, all
Example - us
relation Type of relationship need to find for a concept.

Possible values - is a, finding site, causative agent, procedure site, has active ingredient, has manufactured dose form, has basis of strength substance and all possible values


Example - is a
direction Direction in which relationship need to find for a concept.

Possible values - source, destination.
Example - source

attribute Direction in which relationship need to find for a concept.

Possible values - finding site, causative agent, has intent, procedure site, specimen substance, associated finding, associated with and all possible values


Example - causative agent
destinationid SNOMED CT Concept Identifier.
Example- 34348001
gender Gender of the patient.

Possible values - male, m, female, f
Example - male
birthdate Date of the birth of the patient.

Possible values - any date in MM-DD-YYYY format.
Example - 10-30-2009, 03-10-1991
diagnosisdate Date of the diagnosis i.e. date on which patient was diagnosed.

Possible values - any date in MM-DD-YYYY format.
Example - 01-01-2016

secondary Secondary diagnosis concept id.

SNOMED CT Concept Identifier.
Example - 22298006
moduleId A field in each component release file which represents the development module within which it was created and is maintained.

Example - 900000000000207008

subsumption Boolean value, if true, then method will also return result from the descendants of destinationid that match the criteria.
The default value is false, which will return result only from the given destinationid.
Any value other than 'true' and 'false' will internally be considered as 'false'.
query SNOMED CT Expression Constraint Language (ECL) is used to represent SNOMED CT expression constraints and simple queries. For a quick reference to the key syntax features, please refer to the ECL Quick Reference.
Example :
< 195967001 |Asthma (disorder)| :
116676008 |Associated morphology| =
<< 409774005 |Inflammatory morphology|
About CSNOServ -

CSNOServ is a ready to call Representational State Transfer (REST) API Layer exposed as Web Service. This service can be readily deployed along with application or centrally by the user for one or more products / deployment. This service is provided as part of C-DAC's Toolkit for SNOMED CT (CSNOtk). SNOMED Clinical Terms (SNOMED CT) is the most comprehensive, multilingual clinical healthcare terminology in the world. It is owned, maintained, and distributed by the SNOMED International on behalf of its member countries. CSNOServ includes SNOMED Clinical Terms (SNOMED CT ) which is used by permission of the SNOMED International. All rights reserved. SNOMED CT was originally created by the College of American Pathologists. "SNOMED", "SNOMED CT" and "SNOMED Clinical Terms" are registered trademarks of the SNOMED International (www.snomed.org). It is implicit that use of SNOMED CT in CSNOServ is governed by the conditions of SNOMED CT Sub-license issued by Centre for Development of Advance Computing(C-DAC).

API -
Search - Suggest API provides facility of retrieving best matching suggestions (only Clinical Term) for SNOMED CT Concept by specifying parameters.
    - Search API provides facility to search SNOMED CT Concept by specifying parameters and retrieves result.

Lookup - Lookup APIs provide facility to find information about specified SNOMED CT Concept.

Explore - Explore APIs provide facility to travel through SNOMED CT Concepts in order to learn more about it.

Map - Map API provide facility to convert SNOMED CT Concept to corresponding ICD-10 code by specifying parameters.

DISB - DISB API provide facility to access Drug Information Service Bundle(DISB) to get additional information about Substance, Generic Drug and Medicine.