Skip to main content
Creating a new NHS England: Health Education England, NHS Digital and NHS England have merged. More about the merger.

Female Genital Mutilation - Information Sharing - FHIR API

Share female genital mutilation (FGM) information for children under 18 with relevant NHS professionals across England using our Female Genital Mutilation - Information Sharing (FGM-IS) FHIR API.

Overview

Use this API to share female genital mutilation (FGM) information for children under 18 with relevant NHS professionals across England.

You can:

  • query a patient's FGM status

You cannot currently:

  • create an FGM indicator for a patient
  • delete an FGM indicator for a patient

This API is only for use when the end user is a healthcare worker, not a patient. 

For more details, see Introduction to the FGM Information Sharing Service.

Spine Mini Service Provider (SMSP) options

There are also commercially available products which give easier access to FGM-IS, known as Spine Mini Service Providers (SMSPs).

These and other conforming software products are listed in our Conformance Catalogue.

If you are interested in becoming a provider of one of these products, see Female Genital Mutilation - Information Sharing - SMSP API standards.


Who can use this API

This API can only be used where there is a legal basis to do so. Make sure you have a valid use case before you go too far with your development. 

You must have made this request before you can go live (see 'Onboarding' below).



API status

Version Features Status
1.0 Read only In production
2.0 Read and update Retired
2.1.1 Read and update Retired

Versions 2.0 and 2.1.1 have been retired for external use because nobody is using them externally and they are based on an old version of FHIR (DSTU2). We are hoping to uplift the API to FHIR R4. If this would be useful, you can upvote it on our interactive product backlog.

To see all the features on our roadmap for this API, also see our interactive product backlog, filtered on this API.


Service level

This API is a platinum service, meaning it is operational and supported 24 x 7 x 365.

For more details, see service levels.


Technology

This API is a FHIR API.

Specifically, it is based on the HL7 FHIR DSTU2 1.0.2 specification.

For more details, see FHIR.


Network access

You need a Health and Social Care Network (HSCN) connection to use this API.

For more details, see Network access for APIs.


Security and authorisation

This API is application-restricted, meaning the calling application is authenticated but the end user is either not authenticated or not present.

In particular, this API uses TLS-MA authentication.

For more details, see application-restricted APIs.

The API does not perform any end user authentication or authorisation checks. Rather, the calling system is expected to perform them.

The authorisation rules are specified in our national Role Based Access Control (RBAC) database. For more details, see our national Role Based Access Control (RBAC) database on the registration authorities and smartcards page.


Environments and testing

You can test this API using our Path to Live environments.


Onboarding

You must get your software onboarded before it can go live.

Contact us before onboarding with this API. It uses the Common Assurance Process (CAP) which is tailored for each NHS service.


Interactions

For a full list of interactions for this API, see:

Version Features Status Specification
1.0 Read only In production Read specification
2.1.1 Read and update Retired Read specification

Last edited: 10 November 2022 2:14 pm