How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Comment on Too many profiles, not enough reuse: Insights from 1,300 FHIR packages by Lloyd McKenzie

calendar_today December 12, 2025 person Lloyd McKenzie domain firely-server

In reply to Cooper Thompson.

Exchange architectures SHOULD be at least somewhat reflected in the CapabilityStatement - those would expose what REST APIs need to be supported, what documents and messages are produced or consumed, and what operations are to be invoked or be available.

The part that’s not computable is the business flow that talks about what happens when, however it should still be evident if a given IG is using messaging, REST, documents, and/or operations (and what’s being conveyed in them). IGs should always have CapabilityStatements if they’re setting expectation around system exchange. The only IGs that wouldn’t have these would be those just defining libraries of data structures or that are providing documentation on security or something without setting up exchange expectations

open_in_new Read original post