Sample structures of the E_KYC_CHECK API responses for the USA California mDL Verification.

GREEN

The following response example represents successful checks.

{
    "checks": [
        {
            "answer": "GREEN",
            "checkType": "E_KYC_CHECK",
            "createdAt": "2026-10-16 19:04:42",
            "id": "b5d3a9f1-c4e2-4781-a9b2-3c1d5e6f8a4b",
            "sourceInfo": {
                "id": "usa_gov_mdl_ca"
            },
            "inputDoc": {
                "idDocType": "OTHER",
                "country": "USA"
            },
            "extractedDoc": {
                "country": "USA",
                "idDocType": "DRIVERS",
                "number": "F1234567",
                "issueAuthority": "California DMV",
                "firstName": "John",
                "lastName": "Doe",
                "gender": "M",
                "dob": "2003-10-31",
                "addresses": [
                    {
                        "subStreet": "",
                        "street": "123 CAPITOL MALL",
                        "state": "CA",
                        "town": "SACRAMENTO",
                        "postCode": "95814-0000",
                        "country": "USA",
                        "formattedAddress": "123 CAPITOL MALL, SACRAMENTO, California, United States of America, 95814-0000",
                        "source": "externalDb"
                    }
                ],
                "issueDate": "2025-10-24",
                "validUntil": "2031-10-31",
                "images": [
                    {
                        "imageId": 939717516
                    }
                ]
            },
            "ekycCheckInfo": {
                "confirmationId": "Xj9KpwL2vB4nQ8fRzTc5Ym1H",
                "confirmationType": "oAuth"
            }
        }
    ]
}

YELLOW

The following example represents a case where the verification process is still in progress, and the applicant has not yet completed all required steps.

{
    "checks": [
        {
            "answer": "YELLOW",
            "checkType": "E_KYC_CHECK",
            "createdAt": "2026-11-03 12:18:16",
            "id": "f1e7d9c2-a8b4-4319-9c5d-8a2b3e4f1c7d",
            "sourceInfo": {
                "id": "usa_gov_mdl_ca"
            },
            "inputDoc": {
                "idDocType": "OTHER",
                "country": "USA"
            },
            "ekycCheckInfo": {
                "confirmationId": "Y7wM4cK9vP2xL5jB8nQ3tF1R",
                "confirmationType": "oAuth"
            }
        }
    ]
}

RED

The following response example represents unsuccessful checks.

{
    "checks": [
        {
            "answer": "RED",
            "checkType": "E_KYC_CHECK",
            "createdAt": "2026-10-15 17:01:13",
            "id": "c3a91b48-d7e5-4f12-82a1-9b6d5c3f8e4a",
            "sourceInfo": {
                "id": "usa_gov_mdl_ca"
            },
            "inputDoc": {
                "idDocType": "OTHER",
                "country": "USA"
            },
            "ekycCheckInfo": {
                "confirmationId": "pL3rV8xZ2kB9mN5jC7wQ1tF4",
                "confirmationType": "oAuth"
            },
            "violations": [
                "AUTHORIZATION_DENIED"
            ]
        }
    ]
}

ERROR

The following example represents a case when an error occurred during the check.

{
    "checks": [
        {
            "answer": "ERROR",
            "checkType": "E_KYC_CHECK",
            "createdAt": "2026-10-13 12:28:48",
            "id": "d8f53a12-b9c1-4823-91e8-7c5b62a4f0d3",
            "sourceInfo": {
                "id": "usa_gov_mdl_ca"
            },
            "inputDoc": {
                "idDocType": "OTHER",
                "country": "USA"
            },
            "ekycCheckInfo": {}
        }
    ]
}