List Recommended Connections

Overview

list_recommended_connections lists the healthcare connections discovered for the current user by the RLS/IAS network search, after enable_ias_import_consent and once get_import_tasks shows the search has progressed.

Optional Parameters

person_id (string)

• The identifier of the person whose recommended connections are to be retrieved. If not provided, the tool will attempt to extract it from the access token.

Returns

• recommended_connections — one entry per discovered connection (a CareTeam resource can bundle several), each with:
  • connection_id — a service slug (e.g. "sutter_health"), matching the connection_id convention used by create_connection/disconnect_datasource/etc.
  • connection_type — "direct" or "indirect".
  • qhin — the Qualified Health Information Network's display name (e.g. "Epic Nexus QHIN").
  • discovered_at — when this connection was discovered.
  • care_team_id — the underlying CareTeam resource's id, for cross-referencing resources below.
  • organization_reference — the raw FHIR reference (e.g. "Organization/{id}").
  • organization_name — the organization's display name (e.g. "Sutter Health"), resolved via a single batched Organization lookup across all connections in the result (not one lookup per connection); null if the lookup failed or the organization has no name.
• resources — the raw underlying FHIR CareTeam resources, unfiltered, for callers who need more than the simplified projection above.
• count — number of raw resources returned (not the count of recommended_connections -- one CareTeam resource can hold multiple participants).