{ "id": "fhir-bulk-data", "url": "/fhir-bulk-data/", "md_url": "/fhir-bulk-data.md", "json_url": "/fhir-bulk-data.json", "claims_url": "/fhir-bulk-data/beweringen/", "type": { "code": "Specification", "label": "Standaard of specificatie" }, "schema_type": "CreativeWork", "lang": "nl", "translation": null, "title": "FHIR Bulk Data Access ($export)", "aliases": [ "Bulk Data", "Flat FHIR", "Bulk FHIR", "$export", "hl7.fhir.uv.bulkdata" ], "names": { "nl": "FHIR Bulk Data Access", "fr": "FHIR Bulk Data Access", "en": "FHIR Bulk Data Access (Flat FHIR)", "de": "FHIR Bulk Data Access" }, "jurisdiction": [ { "code": "internationaal", "label": "Internationaal" } ], "themes": [ { "code": "secundair-gebruik", "label": "Secundair datagebruik en registers" }, { "code": "architectuur-en-infrastructuur", "label": "Architectuur en infrastructuur" }, { "code": "standaardisatie-en-governance", "label": "Standaardisatie en governance" } ], "lifecycle": { "code": "trial-use", "label": "trial-use" }, "lifecycle_note_html": "Trial use: versie 3.0.0 (STU 3) van 11 december 2025 is de officiële versie; de STU 4-ballot van 7 augustus 2026 is een voorpublicatie, geen release.", "version": "3.0.0 (STU 3, FHIR R4); 4.0.0-ballot (STU 4)", "vendor": null, "sectors": [], "homologations": [], "links": [ { "kind": { "code": "documentatie", "label": "Documentatie" }, "url": "https://hl7.org/fhir/uv/bulkdata/", "label": "FHIR Bulk Data Access (HL7)", "host": "hl7.org", "lang": "en" }, { "kind": { "code": "repository", "label": "Broncode of pakketten" }, "url": "https://github.com/HL7/bulk-data", "label": "HL7/bulk-data (GitHub)", "host": "github.com", "lang": "en" } ], "summary_text": "FHIR Bulk Data Access, ook 'Flat FHIR', is een HL7-specificatie om grote hoeveelheden FHIR-gegevens in één keer van een server naar een vooraf geautoriseerde client te halen, waar gewone FHIR-verzoeken honderdduizenden aanroepen zouden vragen. De operatie $export maakt asynchroon NDJSON-bestanden aan voor alle patiënten, een groep of de hele server; toegang verloopt bij voorkeur via SMART Backend Services. Het dient onder meer om EPD-gegevens naar een onderzoeksdatabank te halen. Een ballot voor versie 4 voegt Bulk Submit en Bulk Publish toe.", "summary_html": "

FHIR Bulk Data Access, ook 'Flat FHIR', is een HL7-specificatie om grote hoeveelheden FHIR-gegevens in één keer van een server naar een vooraf geautoriseerde client te halen, waar gewone FHIR-verzoeken honderdduizenden aanroepen zouden vragen. De operatie $export maakt asynchroon NDJSON-bestanden aan voor alle patiënten, een groep of de hele server; toegang verloopt bij voorkeur via SMART Backend Services. Het dient onder meer om EPD-gegevens naar een onderzoeksdatabank te halen. Een ballot voor versie 4 voegt Bulk Submit en Bulk Publish toe.

", "last_verified": "2026-11-12", "verification_outdated": false, "sections": [ { "id": "wat-is-het", "title": "Wat is het?", "kind": "tekst", "html": "

FHIR Bulk Data Access, ook 'Flat FHIR' genoemd, is een implementatiegids van HL7 International op basis van FHIR R4[1]. Ze bestaat omdat de gewone FHIR-API's goed werken voor kleine hoeveelheden gegevens, maar voor grote exports honderdduizenden verzoeken kunnen vragen; de gids standaardiseert het exporteren van bulkgegevens van een FHIR-server naar een vooraf geautoriseerde client[1]. Een typisch gebruik is een zorgorganisatie die periodiek bijgewerkte klinische gegevens uit een EPD naar een onderzoeksdatabank haalt[1].

" }, { "id": "hoe-is-het-opgebouwd", "title": "Hoe is het opgebouwd?", "kind": "tekst", "html": "

De exportoperatie. De operatie $export start asynchroon de aanmaak van een exportbestand voor alle patiënten, voor een gedefinieerde groep patiënten of voor alle FHIR-gegevens op de server[2]. 'Asynchroon' betekent dat de client de export aanvraagt en de bestanden later ophaalt, in plaats van op een antwoord te wachten. De server moet de uitvoer minstens als Newline Delimited JSON (NDJSON, één FHIR-resource per regel) kunnen leveren en mag daarnaast andere formaten aanbieden[2].

\n

Toegang. Voor de toegangscontrole raadt de gids (SHOULD, dus geen verplichting) OAuth 2.0 aan volgens het SMART Backend Services-profiel[2]. Dat profiel uit SMART App Launch is ontworpen om met Bulk Data samen te werken, maar dient ook voor andere FHIR-API's[3]; het autoriseert een geautomatiseerde toepassing zonder gebruiker[4].

\n

Versie en status. De huidige gepubliceerde versie is 3.0.0 (STU 3)[1]. In de publicatiehistoriek staat ze als trial use, op basis van FHIR 4.0.1, met datum 11 december 2025, en gemarkeerd als huidige versie[5].

\n

STU 4-ballot: Bulk Submit en Bulk Publish

\n

Op 7 augustus 2026 verscheen een ballotversie 4.0.0-ballot (STU 4), eveneens op FHIR 4.0.1[5]. Dat is een voorpublicatie; de officiële versie blijft 3.0.0[6]. De ballot definieert drie bulkoperaties, elk voor een andere verhouding tussen het systeem dat de gegevens heeft en het systeem dat ze nodig heeft: Bulk Export, Bulk Submit en Bulk Publish[6]. Met Bulk Submit duwt een gegevensleverancier een vooraf afgesproken dataset naar één specifieke ontvanger[6]. Een juridisch kader voor het delen van gegevens (zoals verwerkings- of gegevensgebruiksovereenkomsten) en realtime-uitwisseling vallen buiten de scope[6].

" }, { "id": "waar-wordt-het-gebruikt", "title": "Waar wordt het gebruikt?", "kind": "tekst", "html": "

De gids richt zich op uitwisseling in bulk voor analyse, onderzoek en rapportering, zoals de periodieke export van EPD-gegevens naar een onderzoeksdatabank[1] of een datawarehouse dat een patiëntenpopulatie analyseert[3].

\n

In Belgische specificaties of diensten, waaronder de Belgische FHIR-gidsen (Belgische FHIR-implementatiegidsen), werd geen gebruik van Bulk Data gevonden; de hiaat staat in het register. Of Belgische registers of in België gebruikte EPD's $export ondersteunen, werd evenmin gevonden.

" }, { "id": "wat-betekent-het-voor-een-ziekenhuis", "title": "Wat betekent het voor een ziekenhuis?", "kind": "tekst", "html": "

Bulk Data is relevant voor een ziekenhuis dat gegevens uit het EPD naar een datawarehouse of onderzoeksdatabank wil halen zonder per patiënt verzoeken te sturen[1]. Bulk Submit, nog in ballot, beschrijft het omgekeerde: een vooraf afgesproken dataset naar één ontvanger duwen[6]. De juridische afspraken voor zo'n gegevensdeling regelt de gids niet[6]. Er is geen Belgische verplichting gevonden.

\n

Aanbeveling: vraag bij een EPD-keuze of $export (systeem-, patiënt- en groepsniveau) met SMART Backend Services wordt aangeboden, en behandel Bulk Submit en Bulk Publish als ballot tot STU 4 gepubliceerd is.

" }, { "id": "onzekerheden-en-tegenstrijdige-informatie", "title": "Onzekerheden en tegenstrijdige informatie", "kind": "tekst", "html": "" } ], "relation_groups": [ { "type": "ownedBy", "direction": "uit", "label": "valt onder verantwoordelijkheid van", "relations": [ { "direction": "uit", "type": "ownedBy", "label": "valt onder verantwoordelijkheid van", "other": { "id": "hl7-international", "title": "HL7 International", "url": "/hl7-international/" }, "status": "established", "status_label": "vastgesteld", "note_html": "Gepubliceerd als HL7-implementatiegids op hl7.org.", "valid_from": null, "valid_to": null, "historical": false, "refs": [ 1 ] } ] }, { "type": "dependsOn", "direction": "uit", "label": "hangt technisch af van", "relations": [ { "direction": "uit", "type": "dependsOn", "label": "hangt technisch af van", "other": { "id": "fhir", "title": "HL7 FHIR", "url": "/fhir/" }, "status": "established", "status_label": "vastgesteld", "note_html": "Gebaseerd op FHIR R4.", "valid_from": null, "valid_to": null, "historical": false, "refs": [ 1 ] } ] }, { "type": "recommends", "direction": "uit", "label": "beveelt aan", "relations": [ { "direction": "uit", "type": "recommends", "label": "beveelt aan", "other": { "id": "smart-on-fhir", "title": "SMART App Launch (SMART on FHIR)", "url": "/smart-on-fhir/" }, "status": "established", "status_label": "vastgesteld", "note_html": "SMART Backend Services is de aanbevolen autorisatie (SHOULD), geen verplichting.", "valid_from": null, "valid_to": null, "historical": false, "refs": [ 2, 3 ] } ] } ], "relation_count": 3, "hypothesis_count": 0, "neighbours": [ { "id": "hl7-international", "title": "HL7 International", "url": "/hl7-international/", "type": { "code": "Organization", "label": "Organisatie" }, "status": "established" }, { "id": "fhir", "title": "HL7 FHIR", "url": "/fhir/", "type": { "code": "Specification", "label": "Standaard of specificatie" }, "status": "established" }, { "id": "smart-on-fhir", "title": "SMART App Launch (SMART on FHIR)", "url": "/smart-on-fhir/", "type": { "code": "Specification", "label": "Standaard of specificatie" }, "status": "established" } ], "open_questions_html": [ "Ondersteunen Belgische registers of in België gebruikte ziekenhuis-EPD's de operatie $export?", "Wanneer wordt Bulk Data STU 4, met Bulk Submit en Bulk Publish, definitief gepubliceerd?", "Kan Bulk Submit een rol spelen in verplichte Belgische registratie of rapportering, of blijft die bij eigen kanalen?" ], "open_questions": [ { "id": "oq-d77a5e", "html": "Ondersteunen Belgische registers of in België gebruikte ziekenhuis-EPD's de operatie $export?", "text": "Ondersteunen Belgische registers of in België gebruikte ziekenhuis-EPD's de operatie $export?" }, { "id": "oq-2924bf", "html": "Wanneer wordt Bulk Data STU 4, met Bulk Submit en Bulk Publish, definitief gepubliceerd?", "text": "Wanneer wordt Bulk Data STU 4, met Bulk Submit en Bulk Publish, definitief gepubliceerd?" }, { "id": "oq-525c71", "html": "Kan Bulk Submit een rol spelen in verplichte Belgische registratie of rapportering, of blijft die bij eigen kanalen?", "text": "Kan Bulk Submit een rol spelen in verplichte Belgische registratie of rapportering, of blijft die bij eigen kanalen?" } ], "exchanges": [], "sources": [ { "n": 1, "id": "SRC-e3bf06d5aa", "title": "FHIR Bulk Data Access (Flat FHIR) - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/", "published": null, "first_retrieved": "2026-11-12T19:57:36+00:00", "last_checked": "2026-11-12T19:57:36+00:00", "content_sha256": "cfabdbd478661bc9b9c9016486cbc552ec3888d7fe6c27bd56bd6b99282cc5b6", "link_unreachable_since": null }, { "n": 2, "id": "SRC-d4ea422d02", "title": "FHIR Bulk Data Access - Bulk Data Export", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/export.html", "published": null, "first_retrieved": "2026-11-12T19:57:38+00:00", "last_checked": "2026-11-12T19:57:38+00:00", "content_sha256": "c36bb7ece0de9b7da2db83c2c72798a02c69acc8da24403150b8406b39261bb2", "link_unreachable_since": null }, { "n": 3, "id": "SRC-5b357ff62a", "title": "SMART App Launch - Backend Services", "publisher": "HL7 International", "url": "https://hl7.org/fhir/smart-app-launch/backend-services.html", "published": null, "first_retrieved": "2026-11-12T19:57:33+00:00", "last_checked": "2026-11-12T19:57:33+00:00", "content_sha256": "20ed28915344311f75b40417046f430491387e52bc4cdd45f4dce1ae869e0c59", "link_unreachable_since": null }, { "n": 4, "id": "SRC-cb5a8034c5", "title": "SMART App Launch Implementation Guide - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/smart-app-launch/", "published": null, "first_retrieved": "2026-11-12T19:57:30+00:00", "last_checked": "2026-11-12T19:57:30+00:00", "content_sha256": "b50fe78d4bedeb9f65f7f2ee1d1afa862f24198971cbe1d082ca87b737949f81", "link_unreachable_since": null }, { "n": 5, "id": "SRC-a5e343ac8f", "title": "FHIR Bulk Data Access - package-list.json (publicatiehistoriek)", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/package-list.json", "published": null, "first_retrieved": "2026-11-12T19:57:41+00:00", "last_checked": "2026-11-12T19:57:41+00:00", "content_sha256": "91fd392001d2d561422ccf415bc665017b8f4047b31af2b3acc723d4809c73b6", "link_unreachable_since": null }, { "n": 6, "id": "SRC-c02ed723fb", "title": "FHIR Bulk Data Access - STU 4 Ballot - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/4.0.0-202609-ballot/en/", "published": null, "first_retrieved": "2026-11-12T19:57:39+00:00", "last_checked": "2026-11-12T19:57:39+00:00", "content_sha256": "6205a20f1c90e1490b935eef1790de41c12160ffea3a9b1aa1e060f1d2d47d2f", "link_unreachable_since": null } ], "claims": [ { "id": "CLM-8f5c843d", "statement": "De huidige gepubliceerde versie van FHIR Bulk Data Access ('Flat FHIR') is 3.0.0 (STU 3), gebaseerd op FHIR R4.", "kind": "fact", "kind_label": "feit", "locator": "publicatiebanner", "as_of": "2026-11-12", "source": { "id": "SRC-e3bf06d5aa", "title": "FHIR Bulk Data Access (Flat FHIR) - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-d51dbbe8", "statement": "Bulk Data bestaat omdat de gewone FHIR-API's voor grote exports honderdduizenden verzoeken kunnen vragen; de gids standaardiseert het exporteren van bulkgegevens van een FHIR-server naar een vooraf geautoriseerde client.", "kind": "fact", "kind_label": "feit", "locator": "Home, inleiding", "as_of": "2026-11-12", "source": { "id": "SRC-e3bf06d5aa", "title": "FHIR Bulk Data Access (Flat FHIR) - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-ebb29968", "statement": "Een typisch gebruik is dat een zorgorganisatie periodiek bijgewerkte klinische gegevens uit een EPD naar een onderzoeksdatabank haalt.", "kind": "fact", "kind_label": "feit", "locator": "Home, inleiding", "as_of": "2026-11-12", "source": { "id": "SRC-e3bf06d5aa", "title": "FHIR Bulk Data Access (Flat FHIR) - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-05259f94", "statement": "De Bulk Data Export-operatie ($export) start asynchroon de aanmaak van een exportbestand voor alle patiënten, een gedefinieerde groep patiënten of alle FHIR-gegevens op de server.", "kind": "fact", "kind_label": "feit", "locator": "sectie Bulk Data Export Operation", "as_of": "2026-11-12", "source": { "id": "SRC-d4ea422d02", "title": "FHIR Bulk Data Access - Bulk Data Export", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/export.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-0c1af75a", "statement": "Een Bulk Data-server moet de uitvoer minstens als Newline Delimited JSON (NDJSON) kunnen leveren.", "kind": "fact", "kind_label": "feit", "locator": "tabel Query Parameters, _outputFormat", "as_of": "2026-11-12", "source": { "id": "SRC-d4ea422d02", "title": "FHIR Bulk Data Access - Bulk Data Export", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/export.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-d228395d", "statement": "Voor de toegangscontrole raadt Bulk Data (SHOULD) OAuth 2.0 aan volgens het SMART Backend Services Authorization Profile.", "kind": "fact", "kind_label": "feit", "locator": "sectie Security Considerations", "as_of": "2026-11-12", "source": { "id": "SRC-d4ea422d02", "title": "FHIR Bulk Data Access - Bulk Data Export", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/en/export.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-7f0b5b66", "statement": "SMART Backend Services is ontworpen om samen met FHIR Bulk Data Access te werken, maar kan voor elke FHIR-API gebruikt worden, synchroon of asynchroon.", "kind": "fact", "kind_label": "feit", "locator": "Backend Services, inleiding", "as_of": "2026-11-12", "source": { "id": "SRC-5b357ff62a", "title": "SMART App Launch - Backend Services", "publisher": "HL7 International", "url": "https://hl7.org/fhir/smart-app-launch/backend-services.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-8650ab8b", "statement": "Het Backend Services-patroon autoriseert een headless of geautomatiseerde clienttoepassing zonder dat een gebruiker bij de start betrokken is.", "kind": "fact", "kind_label": "feit", "locator": "Home, sectie Backend Services", "as_of": "2026-11-12", "source": { "id": "SRC-cb5a8034c5", "title": "SMART App Launch Implementation Guide - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/smart-app-launch/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-d391b036", "statement": "Bulk Data 3.0.0 staat in de publicatiehistoriek als trial-use-versie van 11/12/2025 en is als huidige versie gemarkeerd.", "kind": "fact", "kind_label": "feit", "locator": "list, versie 3.0.0", "as_of": "2026-11-12", "source": { "id": "SRC-a5e343ac8f", "title": "FHIR Bulk Data Access - package-list.json (publicatiehistoriek)", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/package-list.json", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-ca9d4843", "statement": "Op 07/08/2026 verscheen een ballotversie 4.0.0-ballot (STU 4) van Bulk Data, op basis van FHIR 4.0.1.", "kind": "fact", "kind_label": "feit", "locator": "list, versies 4.0.0-ballot en 3.0.0", "as_of": "2026-11-12", "source": { "id": "SRC-a5e343ac8f", "title": "FHIR Bulk Data Access - package-list.json (publicatiehistoriek)", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/package-list.json", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-8745e652", "statement": "De STU 4-ballotversie van Bulk Data (4.0.0-ballot) is een voorpublicatie; de officiële versie blijft 3.0.0.", "kind": "fact", "kind_label": "feit", "locator": "publicatiebanner", "as_of": "2026-11-12", "source": { "id": "SRC-c02ed723fb", "title": "FHIR Bulk Data Access - STU 4 Ballot - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/4.0.0-202609-ballot/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-fdf650e1", "statement": "De STU 4-ballot definieert drie bulkoperaties (Bulk Export, Bulk Submit en Bulk Publish), elk voor een andere verhouding tussen gegevensleverancier en gegevensafnemer.", "kind": "fact", "kind_label": "feit", "locator": "Home, overzicht van de operaties", "as_of": "2026-11-12", "source": { "id": "SRC-c02ed723fb", "title": "FHIR Bulk Data Access - STU 4 Ballot - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/4.0.0-202609-ballot/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-f58e8252", "statement": "Met Bulk Submit (STU 4-ballot) duwt een gegevensleverancier een vooraf afgesproken dataset naar één specifieke ontvanger.", "kind": "fact", "kind_label": "feit", "locator": "Home, Bulk Submit", "as_of": "2026-11-12", "source": { "id": "SRC-c02ed723fb", "title": "FHIR Bulk Data Access - STU 4 Ballot - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/4.0.0-202609-ballot/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-ae864106", "statement": "Een juridisch kader voor het delen van gegevens en realtime-uitwisseling vallen buiten de scope van Bulk Data (STU 4-ballot).", "kind": "fact", "kind_label": "feit", "locator": "Home, scope", "as_of": "2026-11-12", "source": { "id": "SRC-c02ed723fb", "title": "FHIR Bulk Data Access - STU 4 Ballot - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/bulkdata/4.0.0-202609-ballot/en/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-66af3fe3", "statement": "Als voorbeeld van een backend service noemt SMART een analyseplatform of datawarehouse dat periodiek een bulkimport uit een EPD doet om een patiëntenpopulatie te analyseren.", "kind": "fact", "kind_label": "feit", "locator": "Backend Services, use cases", "as_of": "2026-11-12", "source": { "id": "SRC-5b357ff62a", "title": "SMART App Launch - Backend Services", "publisher": "HL7 International", "url": "https://hl7.org/fhir/smart-app-launch/backend-services.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true } ], "diagrams": [], "facets": { "type": [ "Specification" ], "jurisdiction": [ "internationaal" ], "theme": [ "secundair-gebruik", "architectuur-en-infrastructuur", "standaardisatie-en-governance" ], "lifecycle": [ "trial-use" ], "section": [ "standaarden", "europa" ] }, "search_terms": [ "FHIR Bulk Data Access ($export)", "Bulk Data", "Flat FHIR", "Bulk FHIR", "$export", "hl7.fhir.uv.bulkdata", "FHIR Bulk Data Access", "FHIR Bulk Data Access (Flat FHIR)" ], "release_id": "2026.11.13-2", "license": "CC BY 4.0" }