CTS2-LE REST API: Requesting Concept Details

The operation can be used to retrieve single codes with its preferred designation. This rest call is a variant of Resolve Value Set (multi-modal) with the minimal required parameter set _query=expandResource, identifier, code.

Example

For instance, the call

http://<host>/WebCts2LE/rest/fhir/ValueSet?
	_query=expandResource
	&identifier=urn:oid:2.16.840.1.113883.5.1
        &version=generated:2015
	&code=M

retrieves only the male code

...
<expansion>
	<timestamp/>
	<contains xmlns="http://hl7.org/fhir">
		<system value="urn:oid:2.16.840.1.113883.5.1"/>
		<code value="M"/>
		<display value="Male"/>
	</contains>
</expansion>
...

The same call can be performed to check wether a (code, code system)-pair is contained in a value set. If this pair is not contained the call yields an atom response with an expansion element that does not has any contains-elements as children:

...
<expansion>
   <timestamp />
</expansion>
...