Verify a DCC

This guide will step through how to verify a Digital Covid Certificate (DCC) and present it as either QR code or encoded string.

Prerequisites

You need to the following in order to proceed with this tutorial:

- Access to MATTR VII APIs

- A trusted document signer loaded into the MATTR DCC Extension

- A signed EU Digital Covid Certificate represented as a base45 encoded string.

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

Verify a DCC by invoking the API as follows.

Request

html
Copy to clipboard.
1POST https://YOUR_TENANT_SUBDOMAIN.vii.mattr.global/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}

The payload in the request is the encoded & signed DCC represented as a string.

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}

The response includes a true/false flag which indicates the outcome of the verification. Along with this verified flag, the associated payload and metadata from the certificate is returned.

The data handled during the verification is not stored at any stage on the MATTR platform. The information is held temporarily in memory to allow the processing of the request and discarded once presented back in the response.