Skip to main content

Clinical test data

Further details on clinical testing for GP Connect Access Record: Structured.

Page contents

Overview

Use the GP Connect demonstrator to clinically assure your product. The test data reflects a variety of data statuses and permutations rather than being clinically correct. 

We plan to evolve the test data to reflect changes in the specification or additional scenarios identified to support testing. The data doesn't cover every possible permutation, but it does include a wide variety of common and edge cases from all GP suppliers. Some scenarios may be specific to some providers, but not all.

The Development section of the Access Record: Structured specification describes how the provider suppliers will populate the messages – from the overall structure to the detail of how the codeable concept data type will be populated and should be processed. It specifies the population requirements of each resource at a granular level stating whether each element is mandatory, required or optional. As a general rule, consuming systems must support required and mandatory fields if they are relevant to their use case.

Medications

Retrieving test patients from the demonstrator

Use these code samples to send requests to the GP Connect demonstrator to retrieve the test patient data:

Medications test patient 1

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientNHSNumber",
      "valueIdentifier": {
      "system": "https://fhir.nhs.uk/Id/nhs-number",
      "value": "9690937316"
      }
    },
    {
      "name": "includeMedication"
    }
  ]
}

Medications test patient 2

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientNHSNumber",
      "valueIdentifier": {
      "system": "https://fhir.nhs.uk/Id/nhs-number",
      "value": "9690937324"
      }
    },
    {
      "name": "includeMedication"
    }
  ]
}

To send a test request:

  1. First copy one of the above code excerpts.
  2. Open the Demonstrator: Access Record Structured page.
  3. Click on 'Post' and then on 'Try it out'. 
  4. In the body section, delete any existing code and then paste in the code.
  5. Remove the extra brackets.
  6. Click on 'Execute'.

Clinical test data descriptions

This spreadsheet contains medication data extracted from the JSON response in a more readily viewable format. Reference values are included in the hidden columns to make it easier to find the medication in the JSON file if required.

Presentation and processing

We've worked with consumers previously to help them understand the data they receive from the GP Connect API. Read our Medications presentation and processing guidance.

Resource relationships

For the representation of medication processes using FHIR® profiles in GP Connect, visit Medication resource relationships in the specification.

Allergies and adverse reactions

Retrieving test patients from the demonstrator

Use this code sample to send requests to the GP Connect demonstrator to retrieve the test patient data:

Allergies test patient

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientNHSNumber",
      "valueIdentifier": {
      "system": "https://fhir.nhs.uk/Id/nhs-number",
      "value": "9690937332"
      }
    },
    {
      "name": "includeAllergies"
    }
  ]
}

To send a test request:

  1. First copy the above request code.
  2. Open the Demonstrator: Access Record Structured page.
  3. Click on 'Post' and then on 'Try it out'. 
  4. In the body section, delete any existing code and then paste in the code.
  5. Remove the extra brackets.
  6. Click on 'Execute'.

Clinical test data descriptions

This spreadsheet contains allergy data extracted from the JSON response in a more readily viewable format. Reference values are included in the hidden columns to make it easier to find the allergy or adverse reaction in the JSON file if required.

Presentation and processing

We've worked with consumers previously to help them understand the data they receive from the GP Connect API. Read our Allergies presentation and processing guidance.

Allergies guidance

For information on the representation of allergies and intolerances in GP Connect, see the Allergies guidance section of the specification.

Last edited: 5 October 2021 9:59 am