Only this pageAll pages
Powered by GitBook
1 of 21

MLDS User Guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

MLDS Terms of Service

PLEASE READ THESE TERMS AND CONDITIONS CAREFULLY BEFORE USING THIS SNOMED INTERNATIONAL SITE

By continuing to browse and use this website You are agreeing to comply with and be bound by the following terms and conditions of use, which govern our relationship with You in relation to this website.

"We", SNOMED International, operate this site. We are registered in the United Kingdom and have our registered office at 1 Kingdom Street, Paddington London, W2 6BD, United Kingdom. "You" are the user of this website.

TERMS AND CONDITIONS OF USE

We may update our website, including these terms, from time to time, and may change the content at any time, in each case, without notice. Please note that we do not guarantee that our site, or any content or information on it, is complete, up-to-date, error-free or free from inaccuracies or omissions.

The content on our website is provided for general information only. You should not rely on any information provided on our website, and it is your own responsibility to ensure that any products, services or information available through this website meet your specific requirements.

We are the owner or the licensee of all trademarks, copyrights, and other intellectual property rights in our site, and in the material published on it. Those works are protected by copyright laws and treaties around the world. All such rights are reserved.

Our website may include links to other websites. These links are provided for your convenience and do not represent our endorsement of those website(s). We have no responsibility for the content of the linked website(s).

To the extent permitted by law, we exclude all conditions, warranties, representations or other terms which may apply to our website or any information or content on it, whether express or implied.

We will not be liable to You or any other person for any loss or damage, whether in contract, tort (including negligence), breach of statutory duty, or otherwise, arising under or in connection with: (i) Your use of, or inability to use, our website; (ii) Your use of or reliance on any content displayed on our website; or (iii) loss or damage caused by a virus or other technologically harmful material that may infect your computer equipment due to Your use of our website (or any website linked to it).

Your use of this website in breach of these terms may give rise to a claim for damages and/or be a criminal offence.

Provide Feedback

NRC Staff Accounts

If you have not already been assigned an account to manage affiliates within the MLDS, please send an email to providing your name, email address and related NRC name.

If you have, please go to the login page here - - and enter in the same user name and password that you use to log in to Confluence.

techsupport@ihtsdo.org
https://mlds.ihtsdotools.org/#/login
Provide Feedback
If you need to reset your password , do not use the 'Forgot your password' link on MLDS as this is not intended to be used by admin staff.. Please go here - \- and enter in your email address. You will receive an email which will take you to a Confluence page to reset your password.

Registration

  • The landing page for affiliates looking to use SNOMED CT in non-member countries can be found here – https://mlds.ihtsdotools.org

Step 1. Initial Registration

  • Click on the Register button and you will be taken to the initial registration screen.

Step 2. Account Activation

  • Once you have completed the initial registration, you will be sent an Account Activation email to confirm your email address and allow you to continue your registration. In the email you receive, is the confirmation URL which will take you to the next step:

  • You will be asked how you will be using SNOMED CT

    • Commercial

    • Academic

_ &#xNAN;_

  • Any information that falls outside of the requested data should be recorded in the Other Activities section. Affiliates are required to notify IHTSDO prior to engaging in any activities that do not fall within the existing categories at which time the IHTSDO will determine the appropriate Fee Structure for the activity in question

  • The final section asks for you to confirm that you have read and accept the terms of the SNOMED CT affiliate license ( )before clicking the register button where you will be asked to confirm the information on your application before the final submission.

  • At this point, you will now be redirected to your dashboard, where you will be able to see the status of your application and the standing of your account.

  • Once your application has been reviewed and approved your Account Information Status will change to Pending Invoice as shown below.

  • Once your invoice is paid, your Account Information Status will change to In Good Standing and you will be able to access the SNOMED CT Releases as well as any other extensions or other files that are available.

Release Management

  • Edit Package - enables editing of Release Package name and description

  • View License - enables viewing of the license for the Release Package selected, note license must be uploaded via the Edit License option firs t

Individual
  • Other

  • You will then be asked the type of your organization:

    • Developer

    • Development

    • Educational

    • Healthcare Provider

    • Personal

    • Research

    • Vendor

  • Finally, you will be asked for the type of agreement:

    • Normal

    • Research

    • Public good.

  • Next, you will be asked to provide information about yourself or your organization as well as a billing address (if applicable) for invoices to be sent.

  • Your current and planned usage for the current year needs to be provided, along with a summary of the purpose of your SNOMED CT deployment and the status of implementation.

  • Step 3. Registration Details

    Step 4. Registration Details

    Step 5. Final Registration Details

    Step 6. Dashboard

    Step 7. Account Status

    Step 8. Full Access

    http://www.ihtsdo.org/resource/resource/117
    Provide Feedback
    The usage section then needs to be completed in order to get access to download SNOMED CT. You will be asked for the countries where the product will be used. Your Home Country that you have initially registered with will be automatically added, however you will need to select and add any other non-member country in which you plan to use SNOMED CT. You should only be able to select non-member countries at this stage. Currently you are able to select member countries, do note that this is a bug in the system which we are working on correcting. You should not enter any countries that are currently members of the IHTSDO._**
    * The section below will be required information that will need to be provided for each country that you have selected.
    You will be asked for the names of hospitals where SCT will be deployed and dates that the product was started in use and, if applicable, ceased usage. Please note the start date of use is a mandatory _entry, you can add hospitals by clicking on the Add Hospital/Institution button which will take you to the entry screen below.
    * You will also be asked for the number of practices (locations or premises) where SCT is in use (note that the practices do not have to be named, unlike for hospitals). You can add practices by clicking on the Edit Practices button which will take you to the entry screen below.
    * Along with each Hospital or Practice that is entered there will also be a section related to Staffing and Data Analysis use, which you can access by clicking the Edit Data Analysis button. The following definitions apply to terms used on this form:
    * Data Creation System - a system for the entry, processing and storage of data. 
    * Data Analysis System - a system for the collection, organization, analysis, interpretation and presentation of data.  

    Edit License - enables end user to upload a license for the Release Package selected

  • Add Version - enables end user to add a version to the Release Package

  • Delete - enables end user to delete the Release Package selected

  • Click Edit Package menu option, edit as desired and click update to complete.

    To view a license for the selected Release Package, click on View License and the license file will be downloaded to the end users local drive for viewing. The end user must use the Edit License option to add the license first.

    Once the end user has added the Release Package, and added at least one version, they must Publish the Release Package in order for it to be Public.

    Click on Publish Online menu option and then Confirm Publishing message will appear, if it is the correct version to publish click Yes.
    The version now appears under the Public Versions listing and is no longer Offline or NOT Public. Affiliates can now apply to access this Release Package.
    New menu options are now available for under the Public Versions section
    • Edit - enables editing of Release Package name, description and release date

    • Take Offline - enables the version to be removed from Public Access,

    Once a version is "Taken Offline" it can remain offline or it can be deleted if desired by using the Delete option in the Offline Versions menu.
    To access menus and options regarding Release Packages on the Release Management page, simply click on the Release Package name.

    To add a file, see the Release Management Technical Details page for more details.

    Page At A Glance

    Provide Feedback

    Step 1 - To add a Release Package, go to the Release Management menu and Click on Add Release button as shown below.

    Step 2 - Enter Release Package name and description.

    Step 3 - Adding Versions to the Release Package

    Edit Menu - The edit menu has several options

    Edit Package Option

    View License Option

    Edit License Option

    Step 1 - Add information as directed below and press save.

    Step 2 - Confirm Upload and Replace by clicking green button.

    Step 3 - New license file is confirmed and the end user will receive the below message

    ADD Version Option - Add information as directed below and press save.

    Publishing a Release Package

    Adding a file

    Translating MLDS

    There are three things that need translating, and the necessary files can be found on this page covering the following parts:

    The interface and email messages need to be translated, whilst the third section is optional depending on the Member country preference.

    Available tooling

    SNOMED International provides an online translation tool, https://translate.snomedtools.org, which can be used to translate the MLDS interface and email messages.

    To access the translation tool, you will need to request an account via techsupport@snomed.org, explaining that the account is needed to translate MLDS.

    Once you have received the invite, follow the instructions in the email, then go to the MLDS translation project at https://translate.snomedtools.org/projects/mlds/.

    You will see the following screen:

    Find the language you want to translate and then, looking along the relevant row, click on the Untranslated column, which will open the following screen:

    At the top of the page, you can see the English word to translate (in this case, 'Home') and an empty box where you can enter the translation.

    Once you have entered the correct translation, change the Review State to Approved, then click the 'Save and Continue' button. This will then take you to the next untranslated phrase.

    Once you have completed all the translations, please inform .

    • There is no need to complete the translations in one session as they are saved on the server.

    • There are also automated translation options further down the page that can speed up the process. If you are happy with one of the translations, click in the 'Accept and Approve' button on the relevant row.

    The following files may also need to be translated before they can be added to the site, mainly the terms & conditions and the affiliate license. This is a more straightforward translation of the files' contents, but the choice to translate them is up to the Member country.

    Please request more information from if needed.

    Application and Account Status Meanings

    1. Approved - Application is approved.

    2. Declined - Application is declined.

    3. Change Requested - An Action has been sent to the Affilate to comply and is under further review before approval is granted.

    In Good Standing - Affiliate is approved they have paid or they have been Re-activated, they have complete access.

  • Pending Invoice - Affiliate has access to the account but can not download, once payment is received, Admin places account In Good Standing.

  • De-Activation Pending - Flags an Affiliate account but they can not download releases, they have a certain time to respond to an IHTSDO action. They have access to their account.

  • De-Activated - Affiliate Account is De-Activated for failure of payment or other infraction; they have no Access to download and have no access to their MLDS account. The reason for De-activation is noted to Affiliate.

  • Application Status

    Account Status

    Useful Hints

    Other Files

    techsupport@snomed.org
    techsupport@snomed.org
    Provide Feedback
    Provide Feedback

    MLDS Syndication

    Working with the SNOMED CT community, SNOMED International produced the following syndication standard, which has now been implemented in MLDS. The feed can be viewed here: https://mlds.ihtsdotools.org/api/feed

    Terminology Server Syndication Standard

    As part of a strategy to move towards wider adoption of healthcare terminology servers which implement the HL7 FHIR Terminology Services, a more effective way of distributing terminology would be from server to server through a syndication feed.

    Based on existing work implemented by the Australian Digital Health Agency, this feed extends the Atom Syndication Standard. It is not specific to SNOMED CT and can be used for any relevant healthcare standard,

    The additions here are from SNOMED International and are in the sct namespace, http://snomed.info/syndication/sct-extension/1.0.0, for distributing SNOMED CT content.

    SNOMED CT Specific extensions

    A live feed is now available from SNOMED International - Members Distribution and Licensing Service

    Example feed can be seen in this repo - .

    The extensions to the specification are as follows:

    These are SNOMED CT specific extensions to specify any package dependency for a given release package that are not included in the package itself. Dependencies can be on editions or other derivatives.

    by definition include all their dependencies and therefore do not have a sct:packageDependency element.

    always depend on other packages' content not included in the extension package and therefore always have a sct:packageDependency element.

    and can therefore be distinguished by the absence or presence of a sct:packageDependency element.

    Within a sct:packageDependency element

    • sct:editionDependency states any necessary edition dependency and version using the SNOMED CT URI standard, e.g. http://snomed.info/sct/900000000000207008/version/20220731. Where a package is transitively dependent on multiple editions, only the direct non-transitive dependencies should be stated. Downloading packages would complete when there are no further dependencies.

    • sct:derivativeDependency states any necessary derivative dependency, as they are often published outside of SNOMED CT editions. Similarly, this should also follow the SNOMED CT URI standard for module and version

    While all types of entries can be put into one feed, it is also possible to host these entries in separate feeds. For examples

    • an editions feed - edition packages of available SNOMED CT Editions/Extensions

    • an extensions feed - extension packages of available SNOMED CT Extensions

    • a derivatives feed - extension packages of available SNOMED CT Derivatives

    Given that most implementers prefer a ready to use package to parts and assembly instructions, most implementers will be interested in edition packages rather than extension packages.

    Providing a feed containing only edition packages without extension packages would be the least confusing entry point for most implementers with the least learning and decision making required.

    Additional feeds for extension packages and derivatives would be useful for other implementations and are still worth providing.

    A complete feed that is the union of these three feeds can also be potentially provided.

    The major distinction between extensions and derivatives is that extensions add/modify core components, where derivatives are limited to reference sets providing non-core "bolt on" content.

    For editions, most implementers want a ready to use package rather than parts and assembly instructions. Assembling an edition from an extension package and a base edition is not a trivial exercise, requiring content to be combined and a snapshot calculated based on the .

    For this reason edition packaging is preferred as the primary distribution method extensions. Extensions may also be provided in extension packaging, however if only one is made availabe edition packaging is preferred.

    The rationale for this recommendation is that

    • implementers desiring an extension package are in the minority and more capable of disassembiling an edition package if necessary

    • the majority of implementers would prefer a ready to use edition package, and the task of assembling that from an extension and base edition package and calculating a snapshot based on the is burdensome.

    Derivatives are designed to bolt on to an edition, and as such are either "pre-mixed" into an edition package or provided as an extension package.

    When provided by themselves, they make most sense provided as an extension package so they can be "bolted onto" a number of different compatible editions. Therefore the preferred packaging of a derivative is an extension package.

    Note that this preference does not preclude prepackaging one or more derivatives in edition packages where useful.

    Extensions, as opposed to derivatives, add/modify core components - concepts, descriptions and axioms/relationships. These changes affect the Snapshot state of components, as well as potenitally affecting classification and Necessary Normal Form calculation (for example non-leaf concept addition).

    An Extension (adding/modifying core components) published as an extension package should only be a Delta or a Full . Such a package can be applied to a referenced base edition, and then a Snapshot calculated using the . Because an Extension affects the Snapshot state in this way, potentially requiring reclassification and Necessary Normal Form recalculation, a Snapshot extension package of an Extension cannot be simply appended to a base edition's Snapshot. For this reason, the Snapshot Release Type for extension packages of SNOMED CT Extensions should not be used.

    In the simpler Derivative case (map, refset, even language translation with additional descriptions) a Snapshot extension package being simply appended to a Snapshot base edition is safe and simple because the derivative simply adds new components and does not affect the state of existing components.

    The Snapshot Release Type for an edition package does not have these issues as the base edition content is included in the resolved Snapshot Release Type of the package.

    To aid human readability and distinguish between packages, the following naming conventions should be applied.

    1. Edition packages

      1. Should contain the word edition

      2. Should NOT contain the word extension

    For example, titles following these conventions are

    • SNOMED CT-International Edition 2023-04-30 (RF2 SNAPSHOT)

    • SNOMED CT-International Spanish Extension 2023-10-31 (RF2 FULL)

    Each feed entry should always have one link rel="alternate" link. This will generally be the SNOMED CT package to download.

    There can also be one or more link rel="related" entries for any related files, including Release Notes or other relevant files.

    Each link will have the following attributes:

    • type - the type of file being downloaded, e.g. type="application/zip" or type="application/pdf"

    • href - the URL link to download the file

    In each feed entry, the category will indicate the type of RF2 package. The expected types are as follows:

    • SCT_RF2_ALL: Containing the Snapshot and Full RF2 release files (and potentially the Dela Rf2 files but this is not mandatory)

    • SCT_RF2_FULL: Containing only Full RF2 release files

    • SCT_RF2_SNAPSHOT: Containing only Snapshot RF2 release files

    Most available RF2 packages will contain all the necessary release files and will, therefore, have a feed entry item as follows:

    The standard does not mandate any authentication, and this is left to the implementer of the Atom feed provider to implement whatever is needed, depending on any terminology product license requirements.

    Syndication of terminologies has a number of use cases. A few examples are:

    Automatic distribution of content products by their owners:

    • International content products

    • National content products

    • Regional content products

    Automatic import of selected products and dependencies as updates become available:

    • Automatic update of existing terminology server instances

      • Browser server containing both published content and daily builds

    • Automatic provision of new terminology server instances

    Where to download SNOMED CT

    Member Affiliate Licensing Information

    If you wish to download either the International Edition of SNOMED CT or any local SNOMED CT extension to use within current SNOMED International Member territories, please see the list below and go to the relevant distribution location.

    If your country is not listed below, please visit .

    _last updated - 15 Apr 2025 _

    Member Country
    SNOMED CT Distribution Location
    Extension packages
    1. Should contain the word extension

    2. Should NOT contain the word edition

  • The version of the package should be included in the title

  • The RF2 Release Type Full/Snapshot should be included as a bracketed suffix to the title

  • length - the size of the file in bytes, e.g. length="533422481"
  • Checksum validity. either of the two following values can be used (chosen by the distributor):

    • sct:md5Hash the MD5 hash function producing a 128-bit hash value used to check the validity of the file, e.g. sct:md5Hash="0290ad7f6e431063166afd91cd2b8c37"

    • ncts:sha256Hash the SHA256 hash function producing a 256-bit hash value used to check the validity of the file, e.g. sha256Hash="902ec61f6ada329bfd6bc487fe7adab0"

  • SCT_RF2_DELTA: Containing only Delta RF2 release files
    Autoscaling

    Edition/Extension/Derivative feeds

    Packaging types for extensions and derivatives

    Extensions

    Derivatives

    Snapshot Release Type for extension packages

    Naming conventions

    File links

    RF2 Package Types

    Authentication

    Use Cases

    feed-example.xml
    Edition packages
    Extension packages
    Edition packages
    Extension packages
    Module Dependency Reference Set
    Module Dependency Reference Set
    RF2 Release Type
    Module Dependency Reference Set
    Provide Feedback
    <sct:packageDependency>
         <sct:editionDependency></sct:editionDependency>
         <sct:derivativeDependency></sct:derivativeDependency>
    </sct:packageDependency>
    <category term="SCT_RF2_ALL" label="SNOMED CT RF2 All" scheme="http://ns.electronichealth.net.au/ncts/syndication/asf/scheme/1.0.0" />

    Andorra

    Argentina

    Australia

    Austria

    Belgium

    Belize

    Brunei

    Canada

    Chile

    Croatia, Rep

    Cyprus

    Czech Republic

    Denmark

    El Salvador

    Estonia

    Finland

    France

    Germany

    Hong Kong, China

    Hungary

    Iceland

    India

    Indonesia

    Ireland

    Israel

    Jamaica

    Jordan

    Lithuania

    Luxembourg

    Malaysia

    Malta

    Netherlands

    New Zealand

    Norway

    Portugal

    Qatar

    Republic of Korea

    Republic of Slovenia

    Saudi Arabia

    Singapore

    Slovak Republic

    Spain

    Sweden

    Switzerland

    Thailand

    UAE

    United Kingdom

    United States

    Uruguay

    Provide Feedback

    Distribution Sites

    SNOMED International's distribution site
    https://mlds.ihtsdotools.org/ad
    https://mlds.ihtsdotools.org/ar
    https://www.digitalhealth.gov.au/healthcare-providers/product-releases
    https://mlds.ihtsdotools.org/at
    https://mlds.ihtsdotools.org/be
    https://mlds.ihtsdotools.org
    https://mlds.ihtsdotools.org/bn
    https://infocentral.infoway-inforoute.ca/en/standards/canadian/snomed-ct
    https://mlds.ihtsdotools.org/cl
    https://mlds.ihtsdotools.org/hr
    https://mlds.ihtsdotools.org/cy
    https://mlds.ihtsdotools.org/cz
    https://mlds.ihtsdotools.org/dk
    https://mlds.ihtsdotools.org
    https://mlds.ihtsdotools.org/ee
    https://mlds.ihtsdotools.org/fi
    https://esante.gouv.fr/produits-services/cgts/snomed-ct
    https://mlds.ihtsdotools.org/de
    https://mlds.ihtsdotools.org/hk
    https://mlds.ihtsdotools.org/hu
    https://mlds.ihtsdotools.org/is
    https://mlds.ihtsdotools.org/in
    https://mlds.ihtsdotools.org/id
    https://mlds.ihtsdotools.org/ie
    https://mlds.ihtsdotools.org/il
    https://mlds.ihtsdotools.org/jm
    https://mlds.ihtsdotools.org/jo
    https://mlds.ihtsdotools.org
    https://mlds.ihtsdotools.org/lu
    https://mlds.ihtsdotools.org/my
    https://mlds.ihtsdotools.org/mt
    https://mlds.ihtsdotools.org/nl
    https://mlds.ihtsdotools.org/nz
    https://mlds.ihtsdotools.org/no
    https://mlds.ihtsdotools.org/pt
    https://mlds.ihtsdotools.org
    https://mlds.ihtsdotools.org/kr
    https://mlds.ihtsdotools.org/si
    https://mlds.ihtsdotools.org
    https://mlds.ihtsdotools.org
    https://mlds.ihtsdotools.org
    http://ticsalutsocial.atoom.space/en/que-fem/interoperabilitat-i-tecnologies/formulari-dobtencio-de-snomed-ct-2/
    https://mlds.ihtsdotools.org/se
    https://mlds.ihtsdotools.org/ch
    https://mlds.ihtsdotools.org/th
    https://mlds.ihtsdotools.org
    https://isd.digital.nhs.uk/trud/user/guest/group/0/pack/26
    https://www.nlm.nih.gov/healthit/snomedct/us_edition.html
    https://mlds.ihtsdotools.org/uy

    Accessing releases

    Once your account has been reviewed and, if applicable, any invoice has been paid, you will now be able to see that you application has been approved and your account will be in a 'good standing' process.

    Step 1. Access to SNOMED CT

    • At this stage you will now have access to download the SNOMED CT International Release by clicking on the 'Releases' link on the top menu or the releases section on your dashboard.

    Step 2. Other Available Releases

    • From your dashboard you can also apply for access to other products, such as national extensions. If you would like to apply to access any national Member space that can be found on the MLDS, you can click on the relevant country where you will be asked to provide information used by the member to review your application. Once approved by that country you will have access to the your selected release.

    Usage Reports

    1. New Usage Declaration Reports

    When an Affiliate completes their application, the usage report can be filled out without completing all of the information. The IHTSDO or Member NRC admin reviews the application and will request additional usage information be completed if required. The Affiliate will see reminder messages that indicate when reports need to be submitted.

    After the initial usage report submission, towards the end of every year, and if applicable, the Affiliate will receive a notification via email that they need to provide a report on the current and planned usage of SNOMED CT in non-member countries, and any member countries they have registered with through the MLDS.

    • On your dashboard you will see your previously submitted usage reports, as well as where to create a new usage report.

    • Click on New Report button.

    If for some reason an affiliate wants to correct a usage report that has been submitted, they must first retract the usage report. They can do this by clicking on the usage report they wish to change and then click the Retract Declaration Button. They can then amend their changes and submit. Any previously submitted Usage reports for the same time period will be superseded.

    2. Create a Usage Declaration Report

    3.Retract a Usage Declaration Report

    Provide Feedback
    * Once you have completed your usage report and it has been submitted, it will be reviewed by IHTSDO staff and, where applicable, an invoice will be sent to you. At this point, your account will be in a 'pending payment' status where you will be unable to download SCT until payment has been received.
    * Add the time period for the declaration year and click Add button.
    * Complete the form and please be aware that the form will use the default values of the previously submitted report, make sure to edit accordingly for accuracy of use in the year you are reporting. Remember to click on the Submit Declaration button as show below, located in the bottom left of form page, when you are finished editing the year.
    * Once Submitted you will see your newly added report in the Usage Report list.
    Provide Feedback
    * You will notice that after you have applied for an extension or release from the selected country the section Applications will reflect the status of your Extension application. SNOMED CT is always your Primary application type.

    Pending Applications

    Here is where you will find any new applications that are waiting to be approved. Click on the Review Button where you will be able to review the application (step1 )and then decide (step 2) if the application can be approved, declined or if you wish to request additional information from the Affiliate.

    List of Applications

    Actions available on an application page

    *

    Approve Application

    If the everything on the application is acceptable and you wish to approve the application, click the

    button.

    You will then see the following dialog box:

    You can either cancel or accept the application by clicking the respective button. On acceptance, an email will be sent to the affiliate informing them that their application has been approved. The Affiliate will now be able to download the International SNOMED CT Edition and any local release packages that you have made available.

    You can now find that affiliate in the Affiliate Management Page.


    Change Requested

    If, having reviewed the application, more information or changes are needed from the applicant, then Admin can click on the "Change Requested From Applicant" button. This will result in the following dialog box:

    The application will be shown with a 'Change Requested' status in the Pending Applications screen as follows:


    When further review of an application is required, the Admin can click the Review Requested from Staff button to flag that application. This button does not work like an on and off flag. In order to remove the Review Requested flag the application must be Approved, a Change Requested from Applicant issued or the application should be Declined.

    If, for whatever reason the application is not approved then Admin should click on the 'Decline Application' button. This will show the following confirmation dialog box:

    This will change the status of the application to declined and the applicant will see the following screen when they log in:

    Review Requested

    Decline Application

    Provide Feedback
    This will allow you the Admin to send an email to the applicant, using an external email client such as MS Outlook, to inform the applicant that they need to make some changes to their application. It is important to note that without sending an email directly to the affiliate, they will not be notified of any change in their application (i.e. they will not receive any notification email from the MLDS system). This is because they must be informed of the changes that they need to make.
    The next time that the affiliate logs in to MLDS, they will see the following screen which tells them that they need to amend their application:
    Until they have made changes and re-submitted the application, Admin will not be able to approve the application.
    * The application will now reflect a Status of Review Requested.
    *
    To provide more details of why their application has been declined, click on the email to open up your email client in order to send the details to the applicant. To then confirm that Admin wishes to decline the application, click on the 'Yes, decline application' button. As with requesting changes, it is important to note that without sending an email directly to the affiliate, they will not be notified of their application being denied (i.e. they will not receive any notification email from the MLDS system). It is the decision of the user whether they need to be informed of the reasons for the decision.

    Affiliates User Guide

    For further details and questions around licensing, please read the following FAQs - https://ihtsdo.freshdesk.com/support/solutions/4000002199

    Other Pages

    • MLDS Privacy Policies

    • MLDS Terms of Service

    Preguntas Frecuentes
    Provide Feedback
    Registration
    MLDS Application Process
    Application and Account Status Meanings
    Accessing releases
    Downloading releases
    Usage Reports

    MLDS Application Process

    In order to get access to the international edition of SNOMED CT and its derivatives, you will need to register and apply for an account. Each application is reviewed by the IHTSDO and follows these steps:

    Primary Application - applies only to SNOMED CT International and its derivatives

    1. An application is made by user providing information such as type of license requested, proposed or current use of SNOMED CT and the non-member countries where it is being used

    2. The application is reviewed by IHTSDO staff, and if applicable, an invoice will be sent based up on the usage of SNOMED CT as detailed in the Affiliate License Agreement (http://www.ihtsdo.org/resource/resource/117). Your account will be put in a pending invoice (payment?) status and you will be able to log in to your account to see the status.

    3. If an invoice has been raised, you will need to send payment for the invoice before you are able to access and download SNOMED CT. Once payment has been received, or if there is no need for an invoice, your account will be put into a 'good standing' status and you will be able download the relevant releases.

    4. At the end of each year, you will be asked to provide an update on the usage of SNOMED CT in order to continue to have access to the release packages.

    1. An application can be made for any other extension, release or derivative other than SNOMED CT while their primary application is under review. Once the application is submitted it will follow the same process as above going into an initial state of Pending until the Member Admin approves that extension application and thier Primary application status changes to "in Good Standing" with payment complete before any downloads are available.

    Extension Application - applies to any other extension, release or derivative other than SNOMED CT, for example an IHTSDO Member's extension

    Provide Feedback

    Preguntas Frecuentes

    ¿Cómo obtengo una Licencia de Afiliación SNOMED CT?

    El proceso utilizado depende de donde esté planificando utilizar SNOMED CT:

    **a)**Países Miembros

    Si usted piensa utilizar, implementar o distribuir SNOMED CT en el territorio de un País Miembro, entonces podrá obtener la licencia desde ese País Miembro. Podrá descargar SNOMED CT desde el sitio web oficial del País Miembro. El uso de SNOMED CT en los Países Miembros es gratuito. Puede encontrar el sitio web oficial de cada País Miembro a través de los enlaces del sitio web de IHTSDO: http://www.ihtsdo.org/members/.

    Si decide utilizar, implementar o distribuir SNOMED CT en otros Países Miembros deberá ingresar al sitio web delMiembro correspondiente para determinar si existen requerimientos para su utilización en ese País Miembro en particular.

    Además de obtener la licencia desde el País Miembro, usted puede obtener la licencia directamente desde IHTSDO. Sin embargo, deberá ingresar al sitio web del País Miembro en que desea implementar o distribuir SNOMED CT para determinar si hay algún requerimiento para para su utilización en ese País Miembro en particular.

    **b)**Países no-Miembros

    Si aun no tiene una licencia para SNOMED CT y planea utilizar, implementar o distribuir SNOMED CT en un País no-Miembro, deberá solicitar una licencia directamente a IHTSDO. Por más información visite el sitio: . Considere que esto podrá implicar costos para el solicitante.

    Deberá notificar a IHTSDO sobre la utilización de SNOMED CT en ese País no-Miembro. Esta notificación se realizará a través del centro de distribución y licenciamiento localde SNOMED CT. Considere que esto podrá implicar cargos para el solicitante. Por más información visite el sitio: . Por otra parte, si su oficina registrada o principal lugar de negocios se encuentra en un País Miembro, deberá notificar al mismo de sus planes de utilizar SNOMED CT en un País no-Miembro.

    Si decide utilizar, implementar o distribuir SNOMED CT en Países Miembros adicionales deberá ingresar al sitio web del País Miembro en cuestión para determinar si existen requerimientos para su utilización en ese País Miembro en particular.

    Puede encontrar el sitio web oficial de cada País Miembro a través de los enlaces de el sitio de IHTSDO: .

    Deberá contactarse con IHTSDO directamente enviando un correo electrónico a . Por favor incluya una descripción completa para que sea posible determinar el importe de la licencia.

    Deberá contactarse con IHTSDO directamente enviando un correo electrónico a . Por favor incluya una descripción completa para que sea posible determinar el importe de la licencia.

    Deberá contactarse con IHTSDO directamente enviando un correo electrónico a . Por favor incluya una descripción completa para que sea posible determinar el importe de la licencia.

    Ya tengo una Licencia de Afiliación con un País Miembro pero deseo utilizar SNOMED CT en un País no-Miembro, ¿qué debo hacer?

    Si ya tengo la licencia de afiliación de un País Miembro X, ¿qué debería hacer si deseo utilizar SNOMED CT en un País Miembro Y?

    Como potencial afiliado, me gustaría implementar una aplicación móvil que utilice SNOMED CT. ¿Dónde debo obtener la licencia?

    Como afiliado potencial o existente, tengo un sistema único que está alojado y provee a múltiples organizaciones de salud en diferentes países. ¿Cómo debo registrar esta información?

    http://www.ihtsdo.org/snomed-ct/get-snomed-ct
    http://www.ihtsdo.org/snomed-ct/get-snomed-ct
    http://www.ihtsdo.org/members/
    info@ihtsdo.org
    info@ihtsdo.org
    Provide Feedback

    Downloading releases

    IHTSDO Member - Dashboard Menu View or Release Package Menu View

    Dashboard Menu View

    Step 1. Once you have clicked on an approved release from the Dashboard view you will be brought to that specific Release Package with the ability to download.

    Step 2. Click on the checkbox to agree to the licence then you will be able to download the Release Package.

    Release Package Menu View

    _ _

    Step 1 - Click on the Release Package that you wish to access.

    _ _

    _

    _

    Step 2 - At this stage you can download an already approved Release Package or you can apply for any additional ones you want. Refer to the right of any Release Package for Status indication as explained below.

    Provide Feedback

    Developer User Guide

    Provide Feedback

    Administration User Guide

    This section is primarily for staff of SNOMED International or Member Countries who are using the MLDS to manage their affiliates.

    Provide Feedback

    MLDS Affiliate Check API Documentation

    SNOMED International's MLDS provides a limited number of APIs to support integration with other systems.

    For further information on the REST APIs to get access to releases, please go to the page.

    All access to the API is over HTTPS to the [mlds.ihtsdotools.org](http://mlds.ihtsdotools.org) domain. All data is sent and received as JSON.

    Client errors on API calls will typically result in a 400 Bad Request response.

    Error responses can be detected by a status code of 4xx or 5xx. The message value is an optional human description of the problem.

    MLDS Affiliate Check API Documentation
    MLDS Release Packages API
    MLDS Syndication
    NRC Staff Accounts
    Pending Applications
    Release Management
    Translating MLDS
    The public APIs do not require authentication to be supplied.

    Where possible the API supports appropriate HTTP Methods/Verbs for each resource.

    Method
    Description

    GET

    Retrieve a representation of the resource.

    POST

    Create a new resource.

    PUT

    Replace a resource.


    Check that an affiliate is in good standing with IHTSDO.

    Where possible the affilateId with confirming matching data from the application can be used, otherwise a single match from all affiliates of a member can be used. [code] GET /affiliates/check?member=:memberKey&match=:keyword[&affilateId=:affiliateId] [/code]

    Name
    Type
    Optional
    Description

    member

    string

    Mandatory

    Identification of the member country that the affiliate has been accepted by. It is either a two-letter country code or IHTSDO to indicate IHTSDO international. The country codes are a subset of the ISO 3166-1 alpha-2 codes. Valid options: AU BE BN CA CL CZ DK EE ES GB HK IHTSDO IL IN IS LT MT MY NL NZ PL PT SE SG SI SK US UY.

    match

    The check API requires a unique match in the Affiliates database. Affiliates are filtered by the member, optionally by affiliate id, and a keyword text match against the identifying fields of the affiliate.

    Once a single affiliate has been identified the affiliate's application must have been approved for the specified member and for the affiliate's account to be considered in good standing.

    If successful then the API will return with a matched: **true**.

    If there is no match then the API will return with matched: **false**.

    No additional information is provided to diagnose a failed match.

    A successful match against a Swedish affiliate based on a match against the [abc@test.com](mailto:abc@test.com) email address. The affiliate was uniquely identified and the account was in good standing.

    An unsuccessful match against an IHTSDO affiliate based a match against the keyword hospital. No affiliate was uniquely identified as many affiliates contained hospital in the searched fields.

    A successful match that limited the search to a single specified affiliate. The 'hospital' keyword matched, unlike before, however, by limiting the search to a single affiliate the result was unique.

    The match value contains user supplied data and as result may need to be escaped using standard URL rules. For example, matching the email address [me+work@email.com](mailto:me+work@email.com) would require escaping the + character as %2B when using curl or else the match request would fail.


    Provide Feedback

    $ curl -i 'https://mlds.ihtsdotools.org/api/affiliates/check?member=IHTSDO&match=spectra' HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Date: Tue, 27 Oct 2015 19:46:30 GMT 
    
    {"matched":true}
    HTTP/1.1 400 Bad Request Content-Type: application/json Transfer-Encoding: chunked Date: Tue, 27 Oct 2015 19:54:17 GMT
    {
    "error": "Bad Request",
    "status": 400,
    "message": "Unknown member: 'xz'. Valid options: AU BE BN CA CL CZ DK EE ES GB HK IHTSDO IL IN IS LT MT MY NL NZ PL PT SE SG SI SK US UY "
    }

    Schema

    Client errors

    Authentication

    MLDS Release Packages API
    $ curl -i 'https://mlds.ihtsdotools.org/api/affiliates/check?member=SE&match=abc@test.com' HTTP/1.1 200 OK Content-Type: application/json
    
    {"matched":true}
    $ curl -i 'https://mlds.ihtsdotools.org/api/affiliates/check?member=SE&match=abc@test.com' HTTP/1.1 200 OK Content-Type: application/json
    
    {"matched":false}
    $ curl -i 'https://mlds.ihtsdotools.org/api/affiliates/check?member=IHTSDO&match=hospital&affiliateId=123' HTTP/1.1 200 OK Content-Type: application/json
    
    {"matched":true}
    $ curl -i 'https://mlds.ihtsdotools.org/api/affiliates/check?member=IHTSDO&match=me%2Bwork@email.com' HTTP/1.1 200 OK Content-Type: application/json
    
    {"matched":true}

    HTTP Methods

    Affiliate API

    Affiliate Check

    Parameters

    Examples

    DELETE

    Delete a resource.

    string

    Mandatory

    Search keyword within the affiliate record. This will match against a number of identifying fields of the affiliate: organization name, first name, last name, street address, email, alternative email, and third email.

    affiliateId

    string

    Optional

    Limit the search to a specific Affilate record.

    MLDS Privacy Policy


    Provide Feedback

    MLDS User Guide

    The Member Licensing and Distribution Service (MLDS) is SNOMED International's online platform for managing SNOMED CT licensing and distributing SNOMED CT release packages. Available at mlds.ihtsdotools.org, MLDS provides a single point of access for individuals and organizations to register their use of SNOMED CT, apply for affiliate licenses, and download SNOMED CT editions and extensions.

    This guide provides step-by-step instructions for using the MLDS platform. It covers registration and the application process, navigating the site and downloading release packages, managing your account and understanding application statuses, submitting usage reports and statements of account, and accessing release packages via the MLDS API. Whether you are a first-time user registering for SNOMED CT access or an NRC administrator managing your country's releases, this guide will help you navigate the platform effectively.

    For further details about licensing and what type of license you need, please read the SNOMED International FAQs.

    If you want to download SNOMED CT, please review where to get the release files.

    MLDS Release Packages API

    Each member organization can make Release Packages available to their approved affiliates for downloading. A Release Package has a current version and past versions. A Release version can contain multiple files that can be individually downloaded by an affiliate.

    Release files are not stored in MLDS and instead a URL is provided where the file can be download from on demand. Files are typically stored on the Amazon s3 service. The URL to directly access the release file is not made available to affiliate users, who instead use a MLDS based URL that in turn download the file from the original location.

    Client errors on API calls will typically result in a 400 Bad Request response.

    Error responses can be detected by a status code of 4xx or 5xx. The message value is an optional human description of the problem.

    The public APIs do not require authentication to be supplied.

    The APIs that do require authentication support Basic Authentication using MLDS credentials.

    Ensure that all communication uses https to ensure the credentials aren't revealed.

    Where possible, the API supports appropriate HTTP Methods/Verbs for each resource.

    Method
    Description

    GET

    Retrieve a representation of the resource.

    POST

    Create a new resource.

    PUT

    Replace a resource.

    List all release packages. [code] $ curl -i 'https://mlds.ihtsdotools.org/api/releasePackages' [/code]

    Name
    Type
    Description

    member.key

    string

    Member organization, either IHTSDO or the two letter country code of the member country

    name

    string

    Name of the Release Package

    Name
    Type
    Description

    name

    string

    Name of the Release Version

    description

    string

    Description of the Release Version. Can be plain text or HTML.

    Add a new release file to a Release Version.

    Name
    Type
    Description

    label

    string

    Short description of the file

    downloadUrl

    string

    URL of file content

    Note that an affiliate download URL is used by affiliates to download the content via MLDS. [/code]

    To publish a Release Version online the Release Version's online flag should be set to true. To take the Release Version offline the online flag should be set to false.

    Name
    Type
    Description

    name

    string

    Name of the Release Version

    description

    string

    Description of the Release Version. Can be plain text or HTML.

    A license document can be associated with a Release Package. [code] POST /api/releasePackages/:releasePackageId/license [/code]

    Name
    Type
    Description

    file

    form-data

    File name of the posted file contents.

    The request should be a `multipart\form-data' post to the server.

    The content associated with a Release File can be downloaded using the value of the `clientDownloadUrl'.

    To download a file content the supplied user credentials must be approved to get access to the member's files.

    The response body is the file content.

    Where possible, the response headers Content-Disposition and Content-Type are set with content meta-data, such as filename.

    Given the existing published Release Package:

    The content for Release file 211928 can be downloaded using the value of the clientDownloadUrl.

    Provide Feedback

    [HTTP/1.1 400 Bad Request Content-Type: application/json Transfer-Encoding: chunked Date: Tue, 27 Oct 2015 19:54:17 GMT
    {"error":"Bad Request","status":400,"message":"Unknown member: 'xz'. Valid options: AU BE BN CA CL CZ DK EE ES GB HK IHTSDO IL IN IS LT MT MY NL NZ PL PT SE SG SI SK US UY "}

    Client errors

    Authentication

    Basic Authentication

    $ curl -u USER:PASSWORD -i 'https://mlds.ihtsdotools.org/api/releasePackages'
    {
      "releasePackageId": 1911,
      "createdAt": "2015-10-14T13:49:09.163Z",
      "member": {
        "key": "SE"
      },
      "name": "Sweden A",
      "description": "sweden a release..",
      "releaseVersions": [
        {
          "releaseVersionId": 1913,
          "createdAt": "2015-10-14T13: 50: 26.918Z",
          "name": "sweden a a 1",
          "description": "some kind of version",
          "online": true,
          "publishedAt": null,
          "releaseFiles": [
            {
              "releaseFileId": 1921,
              "label": "file2",
              "createdAt": "2015-10-14T19: 18: 39.808Z",
              "clientDownloadUrl": "/api/releasePackages/1911/releaseVersions/1913/releaseFiles/1921/download"
            },
            {
              "releaseFileId": 1919,
              "label": "file1",
              "createdAt": "2015-10-14T19: 18: 30.628Z",
              "clientDownloadUrl": "/api/releasePackages/1911/releaseVersions/1913/releaseFiles/1919/download"
            }
          ]
        }
      ]
    },
    {
      "releasePackageId": 5267,
      "createdAt": "2015-10-20T14: 54: 25.733Z",
      "member": {
        "key": "BE"
      },
      "name": "Belgium A",
      "description": "AAAA",
      "releaseVersions": [
        {
          "releaseVersionId": 5269,
          "createdAt": "2015-10-20T14: 54: 44.829Z",
          "name": "Belgium A 1",
          "description": "A 1",
          "online": true,
          "publishedAt": null,
          "releaseFiles": [
            {
              "releaseFileId": 5271,
              "label": null,
              "createdAt": "2015-10-20T14: 55: 01.955Z",
              "clientDownloadUrl": "/api/releasePackages/5267/releaseVersions/5269/releaseFiles/5271/download"
            }
          ]
        }
      ]
    }
    ]
    GET /api/releasePackages/:releasePackageId
    GET /api/releasePackages/:releasePackageId/releaseVersions/:releaseVersionId
    GET /api/releasePackages/:releasePackageId/releaseVersions/:releaseVersionId/releaseFiles/:releaseFileId
    POST /api/releasePackages
    {
      "member": {
        "key": "IHTSDO"
      },
      "name": "Another Release",
      "description": "<p>Another Description<br/></p>"
    }
    {
      "releasePackageId": 211920,
      "createdAt": "2015-10-28T20:39:41.965Z",
      "member": {
        "key": "SE"
      },
      "name": "Another Release",
      "description": "Another Description",
      "releaseVersions": []
    }
    POST /api/releasePackages/:releaseVersionId/releaseVersions
    {
      "name": "First Version",
      "description": "<p><b>First</b> version description <br/></p>"
    }
    {
    "releaseVersionId": 211924,
    "createdAt": "2015-10-28T20:48:21.796Z",
    "name": "First Version",
    "description": "First version description",
    "online": false,
    "publishedAt": "2015-10-28",
    "releaseFiles": []
    }
    POST /api/releasePackages/:releasePackageId/releaseVersions/:releaseVersionId/releaseFiles
    {
      "label": "<p>Example file</p>",
      "downloadUrl": "http://files.com/example.txt"
    }
    {
    "releaseFileId": 211928,
    "label": "Example file",
    "createdAt": "2015-10-29T14:44:52.682Z",
    "clientDownloadUrl": "/api/releasePackages/211920/releaseVersions/211924/releaseFiles/211928/download",
    "downloadUrl": "http://files.com/example.txt"
    }
    PUT /api/releasePackages/:releasePackageId/releaseVersions/:releaseVersionId
    {
      "name": "First Version",
      "description": "<p><b>First</b> version description <br/></p>",
      "online": true
    }
    {
    "releaseVersionId": 211924,
    "createdAt": "2015-10-28T20:48:21.796Z",
    "name": "First Version",
    "description": "First version description",
    "online": true,
    "publishedAt": "2015-10-29",
    "releaseFiles": [
      {
        "releaseFileId": 211928,
        "label": "Example file",
        "createdAt": "2015-10-29T14:44:52.682Z",
        "clientDownloadUrl": "/api/releasePackages/211920/releaseVersions/211924/releaseFiles/211928/download",
        "downloadUrl": "http://files.com/example.txt"
      }
    ]
    }
    $ curl -u USER:PASSWORD -i -F "file=@FILE.PDF" 'https://mlds.ihtsdotools.org/api/releasePackages/211920/license'
    GET /api/releasePackages/:releasePackageId/releaseVersions/:releaseVersionId/releaseFiles/:releaseFileId/download
    {
    "releaseVersionId": 211924,
    "createdAt": "2015-10-28T20:48:21.796Z",
    "name": "First Version",
    "description": "First version description",
    "online": true,
    "publishedAt": "2015-10-29",
    "releaseFiles": [
      {
        "releaseFileId": 211928,
        "label": "Example file",
        "createdAt": "2015-10-29T14:44:52.682Z",
        "clientDownloadUrl": "/api/releasePackages/211920/releaseVersions/211924/releaseFiles/211928/download",
      }
    ]
    }
    $ curl -u USER:PASSWORD -v -o file.pdf 'https://mlds.ihtsdotools.org/api/releasePackages/211920/releaseVersions/211924/releaseFiles/211928/download'
    HTTP/1.1 200 OK
    Content-Disposition: attachment; filename="pdfSample.pdf"
    Content-Type: application/pdf
    Content-Length: 113801
    
    [data not shown]

    HTTP Methods

    Get all release packages

    Response

    Get a single Release Package

    Get a single Release Version

    Get a single Release File

    Create a new Release Package

    Input

    Example

    Response

    Create a new Release Version

    Input

    Example

    Response

    Create new Release File

    Input

    Example

    Response

    Publish a Release Version Online

    Input

    Example

    Response

    Create a Release Package License

    Input

    Download Release File Content

    Response

    Example

    Other Pages

    © Copyright 2026 International Health Terminology Standards Development Organisation, all rights reserved.

    This document is a publication of International Health Terminology Standards Development Organisation, trading as SNOMED International. SNOMED International owns and maintains SNOMED CT®.

    Any modification of this document (including without limitation the removal or modification of this notice) is prohibited without the express written permission of SNOMED International. This document may be subject to updates. Always use the latest version of this document published by SNOMED International. This can be viewed online and downloaded by following the links on the front page or cover of this document.

    SNOMED®, SNOMED CT® and IHTSDO® are registered trademarks of International Health Terminology Standards Development Organisation. SNOMED CT® licensing information is available at . For more information about SNOMED International and SNOMED International Membership, please refer to or contact us at .

    Developer User Guide
    Preguntas Frecuentes
    MLDS Privacy Policy
    MLDS Terms of Service
    Provide Feedback
    Affiliates User Guide
    Administration User Guide

    DELETE

    Delete a resource.

    description

    string

    Description of the Release Package. Can be plain text or HTML.

    publishedAt

    date

    Optional - The publish date of the Released Version. Format: YYYY-MM-DD

    online

    boolean

    True if the release version is available to affiliates to download

    http://snomed.org/licensing
    http://www.snomed.org
    info@snomed.org
    Privacy Policy of MLDSiubenda
    Logo