<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 13.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "HealthKit",
  "identifier" : "/documentation/HealthKit/HKVerifiableClinicalRecord",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "HealthKit"
    ],
    "preciseIdentifier" : "c:objc(cs)HKVerifiableClinicalRecord"
  },
  "title" : "HKVerifiableClinicalRecord"
}
-->

# HKVerifiableClinicalRecord

A sample that represents the contents of a SMART Health Card or EU Digital COVID Certificate.

```
class HKVerifiableClinicalRecord
```

## Overview

[`HKVerifiableClinicalRecord`](/documentation/HealthKit/HKVerifiableClinicalRecord) samples contain data from a SMART Health Card or EU Digital COVID Certificate. Verifiable clinical records combine information about the user’s identity with clinical data, like an immunization record or a lab test result. The organization that produced the data cryptographically signs the bundle.

Apps that use verifiable clinical records can use the cryptographic signature to verify the authenticity of the contents. To verify the card:

1. Access the card’s raw payload using the clinical record’s [`dataRepresentation`](/documentation/HealthKit/HKVerifiableClinicalRecord/dataRepresentation) property.
2. Unzip the payload and parse out the `iss` value, which contains a URL that identifies the organization that issued the card.
3. Get the public key from the issuer.
4. Verify the payload’s signature.

For more information, see [SMART Health Cards Framework](https://smarthealth.cards) and [Electronic Health Certificates](https://github.com/ehn-dcc-development/hcert-spec). You can download example SMART cards for testing and development from [Examples](https://smarthealth.cards/examples/).

## Topics

### Identifying the Subject

[`subject`](/documentation/HealthKit/HKVerifiableClinicalRecord/subject)

Data about the person whose clinical data the card contains.

### Identifying the Issuer

[`issuerIdentifier`](/documentation/HealthKit/HKVerifiableClinicalRecord/issuerIdentifier)

An identifier that represents the card’s issuer.

### Reading Metadata

[`issuedDate`](/documentation/HealthKit/HKVerifiableClinicalRecord/issuedDate)

The date when the issuer created the card.

[`relevantDate`](/documentation/HealthKit/HKVerifiableClinicalRecord/relevantDate)

A date relevant to this record, such as when the issuer administered a vaccine or performed a test.

[`expirationDate`](/documentation/HealthKit/HKVerifiableClinicalRecord/expirationDate)

The date when the card expires.

[`recordTypes`](/documentation/HealthKit/HKVerifiableClinicalRecord/recordTypes)

An array of strings representing the types of records contained in the card.

[`sourceType`](/documentation/HealthKit/HKVerifiableClinicalRecord/sourceType)

The source for the verifiable clinical record

[`HKVerifiableClinicalRecordSourceType`](/documentation/HealthKit/HKVerifiableClinicalRecordSourceType)

The source type for the verifiable clinical record.

[`itemNames`](/documentation/HealthKit/HKVerifiableClinicalRecord/itemNames)

A human-readable description of the card’s contents.

### Accessing the Raw Payload

[`dataRepresentation`](/documentation/HealthKit/HKVerifiableClinicalRecord/dataRepresentation)

A raw representation of the record’s data.

[`JWSRepresentation`](/documentation/HealthKit/HKVerifiableClinicalRecord/jwsRepresentation)

A raw representation of the SMART Health Card’s contents.

## Relationships

### Conforms To

[`CVarArg`](/documentation/Swift/CVarArg)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Hashable`](/documentation/Swift/Hashable)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Sendable`](/documentation/Swift/Sendable)

[`Equatable`](/documentation/Swift/Equatable)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

### Inherits From

[`HKSample`](/documentation/HealthKit/HKSample)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)