The descriptions seem to have a consistent difference from the CT Browser.
To take 869561000000101 as an example the description returned from the API is ‘Assessment for dementia’
On the Snomed CT browser the description is Assessment for dementia (procedure)
Is it possible to get the part in brackets from the API?
It’s not essential - we have enough information from the API description field, it would just be useful if we can import it.
Secondly do the refsets have a lastupdated property we can specify in filters like some of the ODS Terminology Server requests do? Apologies if I missed it in the documentation. Again it’s not essential to us, I just thought I’d ask as I was posting to ask the other question anyway.
Firstly it is worth noting that the NHS England Terminology Server fully supports SNOMED ECL.
So you can write ECL to get most things out of SNOMED for example to get data out of the reference set you are looking for you can use the following ECL (the first ECL is human readable the second is all the Term Server needs):
^1853441000000109|Mental Health Services Data Set assessment procedures simple reference set|
^1853441000000109
Below is how to make a call to the Term Server using an ECL statement. Be aware that the ECL statement needs to be HTTP encoded (e.g. %5E = ^ and %20=).
The Term Server browser, called Shrimp, can really help with developing ECL statements and being able to copy the HTTP encoded value set URL. See this page for a link to Shrimp and short videos on how to use it: Learn about the NHS England Terminology Server - Delen: Home - NHS England. To log in we recommend using one of the email accounts shown, first time you will need to accept some licenses after that you will not need to accept the licenses.
Some useful parameters (in HTTP requests parameters are separated by & character) that can be sent along with the above ECL HTTP request or added to the request you include. These parameters are as follows:
count=: this returns the number of records that you state in this is useful when you are testing commands in applications like Postman so that your request does not return too many rows and cause Postman to take ages trying to format the response. If you want to know how many rows are actually returned see ValueSet.expansion.total. It is worth noting that the Term Server restricts value sets to return 50,000 records. If you hit this limit you will need to use pagination to return the data using the count and offset parameters.
property=: if you set to * (property=*) it will bring back all the SNOMED properties. This is useful if you are not sure what you are looking for and you can see all the properties that are available. From your query above it sounds like you are looking for effective time (effectiveTime). When you know what fields you want set property to the code of the property you are after for example property=effectiveTime this will improve efficiency and performance of your query. If you have multiple properties to return enter a property parameter for each property or alternative return all properties .
includeDesignations=true: as I am sure you are aware SNOMED holds a preferred term, synonyms and Fully Specified Names (FSN). The default is for the Term Server to return the preferred term (that is what appears in the display property). The synonyms and FSNs are captured in the Terminology Server as designations. To retrieve all the designations include this parameter.
I am assuming that you can work out how to get the data you want from the responses using the additional parameters I have listed above.
.