Direct verification of DCCs

The Digital Covid Certificate (DCC) format allows issuing digital health certificates that can represent an individuals' COVID-19 vaccine, test or recovery status. MATTR provides the capability to issue and verify DCCs as a MATTR VII extension.

For verifying/relying parties, the extension provides the core capability to verify issued certificates and prove their authenticity and validity - while also decoding and providing details from the certificate.

Digital COVID certifications provided through the MATTR VII DCC extension adhere to the standards and specifications first adopted in implementations across European Union member states from July 2021. For more information on the EUDCC trust model, please see the certificate specification used by the EUDCC.

This guide will step through how to verify a DCC.

Prerequisites

  • Access to MATTR VII APIs. If you’re experiencing any difficulties, contact us.

  • A trusted Document signer.

  • A signed DCC represented as a base45 encoded string.

If you’re experiencing any difficulties, please contact us.

Request

Make a request of the following structure to verify a DCC:

http
Copy to clipboard.
1POST https://YOUR_TENANT_URL/ext/dcc/v1/verify
json
Copy to clipboard.
1{
2  "payload": "HC1:6BFOXN%TSMAHN-HQO8%TEN*FQ8RESL/R83MJ2FCXK9.JAEJP .I0NUULINJPIRPQHIZC4TPIFRMLNKNM8POCEUG*%NH$RSC98IF3MOAGJGB3D0C5HF80P1FDEZ48MOQ:J* 3I0CU0GQJO9NT.HFCA3 X8 KLYF1FD5-FHWC59NT8X4Q2QC:HQ-77JO+0M7NS A8HJP7NVDEBR0JE+45$0H78HABVCNAHLW 70SO:GOLIROGO3T59YLLYP-HQLTQ9R0+L67PPDFPVX1R270:6NEQ.P6KLU%TE6UG+ZEAT1HQ1BT1VW5IMIBRUFTIPPAIMI.J9WVHDYHT-84LTYD3SZ4I25FMV3ZCU3B5IVV5TN%2UP20J5/5LEBFD-48YIM557AL XK$%2XE557TT25-037:2SP4*2DN43U*0CEBQ/GXQFY73OMBMNVVINARNQA77UJ4O79J3*UJLOJ/G7DG3VIN 73PLN09B6LBUC7AK5J5S8BHJHQA$LPQVGD6QHK*$P8RFR76MK6%ARZWCBCBTBTZSU*FLR3JMX4ICV+7OD+AN-2P8EMJIVDF17F7LT6SF*8UA7OB2JR748CLI 9V+VV10EHSA1"
3}
  • payload: Use the payload element from the response obtained when creating a DCC.

Response

json
Copy to clipboard.
1{
2    "verified": true,
3    "metadata": {
4        "issuedAt": "2021-09-20T20:46:17.000Z",
5        "expiry": "2022-09-20T20:46:17.000Z",
6        "trustedDocumentSignerId": "bc410aa2-1110-4ed9-a099-80f1f01b3889"
7    },
8    "payload": {
9        "ver": "1.3.0",
10        "nam": {
11            "fn": "Smith-Jones",
12            "fnt": "SMITH<JONES",
13            "gn": "Charles Edward",
14            "gnt": "CHARLES<EDWARD"
15        },
16        "dob": "1964-01-01",
17        "v": [
18            {
19                "tg": "840539006",
20                "vp": "1119349007",
21                "mp": "EU/1/20/1507",
22                "ma": "ORG-100031184",
23                "dn": 1,
24                "sd": 2,
25                "dt": "2021-06-11",
26                "co": "NL",
27                "is": "Ministry of Health Welfare and Sport",
28                "ci": "URN:UVCI:01:NL:DADFCC47C7334E45A906DB12FD859FB7#1"
29            }
30        ]
31    }
32}
  • verified: Indicates whether the verification status is true or false.

  • metadata: Includes DCC metadata.

  • payload: Includes DCC payload.

The data handled during the verification process is not stored at any stage on the MATTR VII tenant. It is only held temporarily in memory to allow the processing of the request and discarded once the response is presented.