MedVertical
Open menu

BlogFHIR Operations

Introducing the Records Public Demo

Understand FHIR® data. Verify the change. Explore resources, follow findings and test a correction in the Records public demo — no account required.

Records with a synthetic Patient list, the selected Patient's identifier.use field and terminology findings side by side, in a dark frame cropped at the bottom and right.
André Sheydin
André Sheydin
Founder, MedVertical6 min read
recordsfhirpublic-demovalidation

A validation finding is the start of an investigation. Which field caused it? What does the profile require? And did the correction resolve the issue?

Today, we’re opening the Records public demo. You can browse public FHIR servers, inspect findings in context and try corrections with synthetic examples — without an account or local installation.

Records brings the resource, its relationships and its validation findings into one connected view. Our aim is to make it easier to understand a problem, decide what to change and check the result.

For MedVertical, this is an important step: making the workflow we’re building accessible for people to explore, question and help improve. Whether you build integrations, implement profiles or teach FHIR, we want you to be able to try that workflow for yourself.

Understand FHIR® data. Verify the change.

Open the public demo.

From a finding to a verified correction

Start with the synthetic Patient in the sandbox. Its name.use contains officiall, a deliberate misspelling of official. Records shows the resource beside its validation findings. Select Details, then the finding’s path to see the affected field and the ValueSet behind the message.

The synthetic sandbox Patient with name.use expanded to officiall beside two terminology errors and four information findings.

The rejected value, field path and ValueSet together. Captured in the public Records sandbox, 24 September 2026.

Once you can see the problem, try the correction:

  1. Let the initial sandbox check finish; choose Validate resource if Auto-validate is off.
  2. In JSON, change "use": "officiall" to "use": "official".
  3. Choose Revalidate and inspect Changes since first check. With Auto-validate enabled, the check starts after the edit.

In the recorded example, that one-character change resolves two findings. Four information findings remain. You can see what improved and what still needs attention, then download Findings JSON to keep the result and its validation context.

This small loop is central to Records: understand the finding, change the relevant value and verify the effect. Watch the complete correction, including the before-and-after views.

Compare FHIR R4 with ISiK

A typo is a useful first exercise. Profiles introduce a more interesting question: can the same resource meet one set of requirements and fail another?

Open the ISiK example in the sandbox. The synthetic Patient has a name, birth date, gender and an identifier. The identifier has a system and a value, but no type identifying it as a patient number.

Let the initial FHIR R4 check finish, then choose Compare profiles. ISiK Patient 5.1.3 is preselected; choose Run comparison to check the same, unchanged resource against that profile. Both sets of requirements stay visible.

The live public sandbox compares the same synthetic Patient against FHIR R4 and ISiK Patient 5.1.3, showing the missing Patientennummer identifier requirement.

Live public sandbox, 24 September 2026. The resource is unchanged; the profile requirements differ.

In this check, FHIR R4 reports no errors. ISiK reports an error because it requires a Patientennummer identifier whose type includes MR from http://terminology.hl7.org/CodeSystem/v2-0203. The number is already present; its meaning must be explicit for the receiving system.

Follow the finding’s field path and profile tag to inspect that requirement beside the identifier. Choose Continue with tested profiles, then add identifier[0].type.coding in JSON, with system set to http://terminology.hl7.org/CodeSystem/v2-0203 and code to MR. Revalidate checks the correction under the same ISiK profile. The patient-number error and two related information findings resolve; fourteen information findings remain.

That distinction matters: the first comparison changes the requirements while keeping the data constant. The second changes the data while keeping the selected profile constant. It helps explain why a finding appeared and whether a correction addressed it.

The example pins the official gematik ISiK Stufe 5 package 5.1.3. Use the version required by your own integration. The ISiK walkthrough shows the exact requirement, correction and result, with desktop and mobile views.

Explore data you already work with

The same approach applies beyond the prepared examples. Select a public test server such as HAPI FHIR, Firely, SMART Health IT or Blaze, then choose a resource type under Browse. The demo also includes curated synthetic datasets: Clinical Examples on Medplum and Clinical Scenarios on Aidbox. Available resources and FHIR releases depend on the server.

If you already send synthetic resources to one of those servers, keep the resource ID returned by the server. In Records, select the same server and resource type, then use Show filters → Add → _id to find it. Open Details or JSON to inspect the fields and available findings. More actions → Try a test copy takes it into the sandbox. Capabilities and Search Params show what the selected server supports.

Relationships often explain what a resource means. Open an Observation’s subject reference to inspect its Patient beside it, keeping the source in view. You can follow identifiers, profile context and relationships through the data. Opening a referenced resource for inspection does not mean it was included in the validation check.

For a question that spans several resources, try the dataset-quality example. Its three synthetic Patients and two Observations illustrate completeness, duplicate identifiers and subject references. Open a finding, inspect the affected resources and compare the corrected example. Read the evaluated population alongside the result; other indicators may remain unevaluated.

Know what your result covers

The public demo is a place to explore data and run temporary checks. Check details shows the basis and limits of each result. Keep three things in mind:

  • Use synthetic, non-confidential data. Public test servers are shared; resources can change or disappear. Sandbox checks run on the Records server. A test copy does not change the original resource or create a saved workspace validation run.
  • Read the validation context. Results depend on the input, FHIR release, installed profile versions and available terminology. Unavailable terminology may remain unverified, and checks do not fetch external reference targets. Comparing profiles can also change a finding’s provenance without changing the data.
  • Keep the conclusion within the checked scope. Resolving one finding does not establish that every requirement has been met. A resource-level check cannot demonstrate an entire system’s ISiK conformance. MustSupport obligations also depend on the implementation guide and actor; they are not equivalent to a minimum cardinality of one.

Both inline screenshots were captured in the public sandbox. Their findings describe those recorded examples; your current results may differ. For private servers, recurring evaluations, saved baselines and shared review, explore a Records workspace.

Help shape what comes next

Making Records available this way gives us a shared starting point for the next conversation. You can explore the workflow and show us where an explanation, a relationship or a comparison needs to be clearer.

Start with one resource and one finding. Follow it to the field, inspect the requirement and try a correction. Then tell us: which finding was still difficult to understand, even with its field and profile beside it?

Send us that example, using synthetic data and the relevant FHIR release or profile version. Those concrete cases will help us improve Records and choose the next public examples.

André Sheydin

About the author

André Sheydin

André is the founder of MedVertical and a product and design lead based in Cologne. He has spent more than 25 years shaping digital products, platforms, and design systems across complex domains, including healthcare, pharma, automotive, and SaaS. His work focuses on turning technical requirements into product structures that teams can actually build and operate.

Your next step

Start with one FHIR finding.

Open a public resource, try a synthetic correction and inspect the result. No account required.