--- updatedAt: 2026-09-18T09:54:02.000Z agentTools: projectIndex: https://docs.sumsub.com/llms.txt --- # Get E-Sign (QES) verification results # Overview Use this method to get the results of the [Qualified Electronic Signature Verification](https://docs.sumsub.com/sumsub/docs/qualified-electronic-signature-qes-verification). ## Required permissions To use this method, your [app token](https://docs.sumsub.com/sumsub/docs/app-tokens) must have the **View check results** [permission](https://docs.sumsub.com/sumsub/docs/user-roles#permissions). # Request example ```curl curl -X GET \ 'https://api.sumsub.com/resources/checks/latest?type=E_SIGN' \ -H 'accept: application/json' \ -H 'X-App-Token: ' \ -H 'X-App-Access-Sig: ' \ -H 'X-App-Access-Ts: ' ``` # Response explained The response represents a singleton list of `checks`. ## Root variables The root variables are the core `E_SIGN` check result data items. Some of them may include nested attributes and element fields. | Field | Type | Description | | ---------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `answer` | String | Сheck answer:
  • GREEN — user verification is successfully completed.
  • YELLOW — user verification is currently in progress.
  • ERROR — user verification wasn't completed because the Qualified Trust Service Provider is currently unavailable.
| | `checkType` | String | Indicates that it is a `E_SIGN` check type. | | `createdAt` | Date | Date and time (UTC, format `YYYY-DD-MM HH:MM:SS`) of the latest `E_SIGN` check result. | | `id` | String | Unique identifier of the check. | | `inputDoc` | [Object](#inputdoc-attributes) | Represents the data used for the `E_SIGN` check. | | `esignCheckInfo` | [Object](#esigncheckinfo-attributes) | Includes `E_SIGN` check results. | ## `inputDoc` attributes The following table explains the `inputDoc` attributes representing the data taken from the provided document. | Field | Type | Description | | :----------- | :----- | :----------------------------------------------------------------------------------------------------------------- | | `idDocType` | String | Type of the document provided for verification. For example, `PASSPORT`, `ID_CARD`, `RESIDENCE_PERMIT`, `DRIVERS`. | | `country` | String | Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on). | | `firstName` | String | Applicant first name in the original language as it is in the document. | | `middleName` | String | Applicant middle name in the original language as it is in the document. | | `lastName` | String | Applicant last name in the original language as it is in the document. | | `number` | String | Document number. | | `validUntil` | Date | Date when the document validity expires. | | `dob` | Date | Applicant date of birth (format `YYYY-mm-dd`, for example, `2001-09-25`) as it is specified in the document. | | `email` | String | Applicant email address. | | `phone` | String | Applicant phone number. | ## `esignCheckInfo` attributes The following table describes the `esignCheckInfo` attributes representing the `E_SIGN` check results. | Field | Type | Description | | :------------------ | :------------------------------------------------ | :------------------------------------------------------------------ | | `unsignedDocuments` | [Array of objects](#unsigneddocuments-attributes) | Includes the objects representing documents that need to be signed. | | `signedDocuments` | [Array of objects](#signeddocuments-attributes) | Includes the objects representing signed client documents. | ## `unsignedDocuments` attributes The following table describes the `unsignedDocuments` attributes containing documents that need to be signed. | Field | Type | Description | | :-------- | :------ | :------------------------------------------------------ | | `id` | String | Unique identifier of the document. | | `imageId` | Integer | Image ID represents a document that needs to be signed. | | `name` | String | Document title. | ## `signedDocuments` attributes The following table describes the `signedDocuments` attributes containing signed documents. | Field | Type | Description | | :--------- | :------ | :---------------------------------------------------------------------------- | | `id` | String | Unique identifier of the document. | | `imageId` | Integer | Image ID represents a signed document. | | `name` | String | Document title. | | `signedAt` | Date | Date and time (UTC, format `YYYY-DD-MM HH:MM:SS`) when a document was signed. | # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "sumsub-api", "version": "1.0" }, "servers": [ { "url": "https://api.sumsub.com" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "X-App-Token", "in": "header", "x-default": "" } } }, "security": [ { "sec0": [] } ], "paths": { "/resources/checks/latest?type=E_SIGN": { "get": { "summary": "Get E-Sign (QES) verification results", "description": "", "operationId": "get-e-sign-verification-results", "parameters": [ { "name": "applicantId", "in": "query", "description": "Unique applicant identifier in the Sumsub system.

This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant is created on the Sumsub side, and can be found in the [Dashboard](https://cockpit.sumsub.com/checkus/#/applicants/individual?limit=10&page=0).

If the `applicantId` is unknown to you, use the [Get applicant data (externalUserId)](https://docs.sumsub.com/sumsub/reference/get-applicant-data-via-externaluserid) method to fetch it.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "GREEN/Verification completed": { "value": "{\n \"checks\": [\n {\n \"answer\": \"GREEN\",\n \"checkType\": \"E_SIGN\",\n \"createdAt\": \"2024-11-12 10:28:06\",\n \"id\": \"1cdf9711-4d50-4659-b82a-a12c330dc797\",\n \"inputDoc\": {\n \"idDocType\": \"PASSPORT\",\n \"country\": \"DEU\",\n \"firstName\": \"MUSTERMANN\",\n \"lastName\": \"ERIKA\",\n \"validUntil\": \"2027-02-28\",\n \"number\": \"C01XYCCG9\",\n \"dob\": \"1964-08-12\",\n \"email\" : \"erika@test.com\",\n \"phone\": \"+4912389032156\"\n },\n \"esignCheckInfo\": {\n \"unsignedDocuments\": [\n {\n \"id\": \"1672018978\",\n \"imageId\": 1672018978,\n \"name\": \"Terms And Conditions.pdf\"\n }\n ],\n \"signedDocuments\": [\n {\n \"id\": \"1672018978\",\n \"imageId\": 1919960264,\n \"name\": \"Terms And Conditions.pdf\",\n \"signedAt\": \"2024-11-12 10:28:37\"\n }\n ]\n }\n }\n ]\n}" }, "YELLOW/Verification currently in progress": { "value": "{\n \"checks\": [\n {\n \"answer\": \"YELLOW\",\n \"checkType\": \"E_SIGN\",\n \"createdAt\": \"2024-11-13 08:51:35\",\n \"id\": \"5264b5ba-6caa-4278-916f-0c9d033e181b\",\n \"inputDoc\": {\n \"idDocType\": \"PASSPORT\",\n \"country\": \"DEU\",\n \"firstName\": \"MUSTERMANN\",\n \"lastName\": \"ERIKA\",\n \"validUntil\": \"2027-02-28\",\n \"number\": \"C01XYCCG9\",\n \"dob\": \"1964-08-12\",\n \"email\": \"erika@test.com\",\n \"phone\": \"+4912389032156\"\n },\n \"esignCheckInfo\": {\n \"unsignedDocuments\": [\n {\n \"id\": \"391030655\",\n \"imageId\": 391030655,\n \"name\": \"Terms And Conditions.pdf\"\n }\n ]\n }\n }\n ]\n}" } }, "schema": { "oneOf": [ { "title": "GREEN/Verification completed", "type": "object", "properties": { "checks": { "type": "array", "items": { "type": "object", "properties": { "answer": { "type": "string", "example": "GREEN" }, "checkType": { "type": "string", "example": "E_SIGN" }, "createdAt": { "type": "string", "example": "2024-11-12 10:28:06" }, "id": { "type": "string", "example": "1cdf9711-4d50-4659-b82a-a12c330dc797" }, "inputDoc": { "type": "object", "properties": { "idDocType": { "type": "string", "example": "PASSPORT" }, "country": { "type": "string", "example": "DEU" }, "firstName": { "type": "string", "example": "MUSTERMANN" }, "lastName": { "type": "string", "example": "ERIKA" }, "validUntil": { "type": "string", "example": "2027-02-28" }, "number": { "type": "string", "example": "C01XYCCG9" }, "dob": { "type": "string", "example": "1964-08-12" }, "email": { "type": "string", "example": "erika@test.com" }, "phone": { "type": "string", "example": "+4912389032156" } } }, "esignCheckInfo": { "type": "object", "properties": { "unsignedDocuments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "1672018978" }, "imageId": { "type": "integer", "example": 1672018978, "default": 0 }, "name": { "type": "string", "example": "Terms And Conditions.pdf" } } } }, "signedDocuments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "1672018978" }, "imageId": { "type": "integer", "example": 1919960264, "default": 0 }, "name": { "type": "string", "example": "Terms And Conditions.pdf" }, "signedAt": { "type": "string", "example": "2024-11-12 10:28:37" } } } } } } } } } } }, { "title": "YELLOW/Verification currently in progress", "type": "object", "properties": { "checks": { "type": "array", "items": { "type": "object", "properties": { "answer": { "type": "string", "example": "YELLOW" }, "checkType": { "type": "string", "example": "E_SIGN" }, "createdAt": { "type": "string", "example": "2024-11-13 08:51:35" }, "id": { "type": "string", "example": "5264b5ba-6caa-4278-916f-0c9d033e181b" }, "inputDoc": { "type": "object", "properties": { "idDocType": { "type": "string", "example": "PASSPORT" }, "country": { "type": "string", "example": "DEU" }, "firstName": { "type": "string", "example": "MUSTERMANN" }, "lastName": { "type": "string", "example": "ERIKA" }, "validUntil": { "type": "string", "example": "2027-02-28" }, "number": { "type": "string", "example": "C01XYCCG9" }, "dob": { "type": "string", "example": "1964-08-12" }, "email": { "type": "string", "example": "erika@test.com" }, "phone": { "type": "string", "example": "+4912389032156" } } }, "esignCheckInfo": { "type": "object", "properties": { "unsignedDocuments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "391030655" }, "imageId": { "type": "integer", "example": 391030655, "default": 0 }, "name": { "type": "string", "example": "Terms And Conditions.pdf" } } } } } } } } } } } ] } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"description\" : \"Applicant with id 67346775989cba6a82b621de not found\",\n \"code\" : 404,\n \"correlationId\" : \"3b156dad5a2dfe4bec2485b2039f7e64\"\n}" } }, "schema": { "type": "object", "properties": { "description": { "type": "string", "example": "Applicant with id 67346775989cba6a82b621de not found" }, "code": { "type": "integer", "example": 404, "default": 0 }, "correlationId": { "type": "string", "example": "3b156dad5a2dfe4bec2485b2039f7e64" } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```