Add support for ICD-10 (International Version)

[kaicode]

Context I'm working on Snowstorm, the SNOMED International terminology server. I'm making a major update to allow serving any code system, not just SNOMED CT, via the Snowstorm FHIR API. Snowstorm uses this brilliant HAPI-FHIR library!

Feature Request Several of our members use the International version of ICD-10 so I would like to add support for loading this. I'm creating this issue ahead of submitting a PR for this feature if that's okay?

[KevinDougan]

Support for uploading ICD-10 has already been added:

https://hapifhir.io/hapi-fhir/docs/tools/hapi_fhir_cli.html#upload-terminology

[kaicode]

That looks like ICD-10-CM which is the US variant of the standard which has the code system URL http://hl7.org/fhir/sid/icd-10-cm

This issue is about the international version of ICD-10 which has the system URL http://hl7.org/fhir/sid/icd-10.

See Using ICD-[X] Codes with FHIR.

[kaicode]

Although the two standards sound the same the US version uses a tabular format whereas the International version uses ClaML format. So unfortunately the ICD-10-CM loader can not be used to load ICD-10 (International).

[KevinDougan]

Ah, I mis-read your Issue and I did remember when ICD-10 support was added recently, so I thought you hadn;t seen that latest update ... sorry about that!

Yes, I believe a PR adding support would be great, thanks!

[kaicode]

PR created #3849

[psavva]

Hi,

Where can I download the ICD-10 International Version (ZIP File) to upload into HapiFhir?

[kaicode]

The ICD-10 International ClaML files are available from the WHO ICD download page. The download links only appear on that page if you log in first.

[psavva]

Thank you very much

[LizaKing0]

Hi @kaicode, I think the location of the file has changed since your reply. Do you perhaps know where it has moved to? On the download page I can only find PDF updates for ICD-10, and no ClaML files. Thanks in advance!

[kaicode]

I've spent a long time looking through the WHO websites but can not find the ICD-10 ClaML files. It's possible to find documents about various ICD-10 updates but getting standardised machine readable data is harder.

I've emailed one of their teams to ask.

[LizaKing0]

Hi @kaicode, did anyone respond about the ClaML files? I have the Dutch version but we sometimes also need to use the official English/international and I'm still unable to find it.

Thanks in advance! 🙏

[kaicode]

I'm still trying to get hold of the official download page for this file, no response yet. In the short term this is a copy of icdClaML2019ens.zip that I downloaded from the official ICD website last year.