Athena Core Implementation Guide
2.33.0 - release

Athena Core Implementation Guide - Local Development build (v2.33.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: athenahealth SMART Health Cards

Official URL: https://fhir.athena.io/OperationDefinition/ah-smart-health-cards Version: 2.33.0
Draft as of 2024-04-12 Computable Name: AthenahealthSmartHealthCards

The definition for the $health-cards-issue operation. This operation is an implementation of Health Cards based on the the SMART Health Cards specification https://spec.smarthealth.cards/

URL: [base]/Patient/[id]/$health-cards-issue

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INcredentialType1..*uri

This parameter restricts the request by high-level categories based on FHIR Resource Types such as "Observation" or "Immunization".

INcredentialValueSet0..*uri

Restricts the request by FHIR content such as "any standardized vaccine code for mpox".

INincludeIdentityClaim0..*string

By default, the issuer will decide which identity claims to include, based on profile-driven guidance. If the Health Wallet wants to fine-tune identity claims in the generated credentials, it can provide an explicit list of one or more includeIdentityClaims, which will limit the claims included in the VC.

IN_since0..1dateTime

By default, the issuer will return Health Cards of any age. If the Health Wallet wants to request only cards pertaining to data since a specific point in time, it can provide a _since parameter with a valueDateTime.

OUTverifiableCredential0..*string

Verifiable Clinical Information, modeled in FHIR and presented in a form based on W3C Verifiable Credentials (VC).

OUTresourceLink1..*

Captures the link between any number of hosted FHIR resources and their derived representations within the verifiable credential's, allowing the health wallet to explicitly understand these correspondences between bundledResource and hostedResource, without baking details about the hosted endpoint into the signed credential.

OUTresourceLink.vcIndex0..1integer
OUTresourceLink.bundledResource1..1uri
OUTresourceLink.hostedResource1..1uri

This OperationDefinition is based on the unofficial definition found at https://spec.smarthealth.cards/artifacts/operation-patient-i-health-cards-issue.json.