Overview

Use this method to retrieve information about all uploaded images for the specific applicant.

Request example

curl -X GET \
     'https://api.sumsub.com/applicants/66bb9bd13158c00000223355/metadata/resources'

Response explained

The response is a JSON file that contains the structured data about all uploaded images in the applicant profile. See the response example below.

Field	Type	Description
`items`	Array of objects	Each object represents the data for an individual image.
`totalItems`	Integer	Total number of all uploaded images.

`items` element fields

The following table explains the primary data elements of an individual image.

Field	Type	Description
`id`	String	Unique image identifier.
`previewId`	String	Identifier of the image thumbnail.
`addedDate`	Date	Date and time when the image was uploaded.
`fileMetadata`	Object	Includes such file metadata like name, type, size, and so on.
`idDocDef`	Object	Additional information about the document.
`reviewResult`	Object	Contains extra details of the image check result.
`attemptId`	String	Unique identifier of the current image check attempt. Applicants may initiate several attempts to get verified if, for example, they failed once or changed/added the documents, or you could change the verification level to start another check.
`source`	String	Specifies the source from which the image was obtained and may be any of the following: `liveness` — taken from the liveness check. `videoident` — obtained during video identification. `docapture` — captured during one of the verification steps. `nfc` — extracted during NFC-based ID verification. `externaldb` — retrieved from an external database. `fileupload` — ready-made image file was uploaded into the system.

`fileMetadata` attributes

The follwoing table explains the attributes included in the fileMetadata object.

Field	Type	Description
`fileName`	String	Image file name.
`fileType`	String	Image file type. See our FAQ for a full list of mime-types and acceptable file formats.
`fileSize`	Integer	Image file size (in bytes).
`resolution`	Object	Includes the actual `width` and `height` of the image in pixels.

`idDocDef` attributes

The following table explains the idDocDef attributes representing the additional information about the document.

Field	Type	Description
`country`	String	Alpha-3 code (for example, `DEU`, `GBR`, `ARG`, and so on) of the country where the document was issued.
`idDocType`	String	Type of document that is specified in the level to be provided for verification. For example, `PASSPORT`, `SELFIE`, `VIDEO_SELFIE`, `PAYMENT_METHOD` and so on. See the list of supported document types for details.
`idDocSubType`	String	`FRONT_SIDE`, `BACK_SIDE` or null.

`reviewResult` attributes

The following table explains the reviewResult attributes representing details of the image check result.

Field	Type	Description
`moderationComment`	String	Human-readable comment that explains the reasons for rejection, and that can be shown to the applicant.
`clientComment`	String	Human-readable comment that explains the reasons for rejection, and that must not be shown to the applicant.
`reviewAnswer`	String	Explains the image review result: `GREEN` — the image is approved. `RED` — the image is rejected. See `reviewRejectType` for clarification.
`rejectLabels`	Array of strings	Includes one or more reasons for rejection. The field is available if `reviewAnswer` returns `RED`. For more details, see Temporary rejection and Final rejection clarification.
`reviewRejectType`	String	Indicates the type of rejection: `FINAL` — final rejection in case of major violations. For example, the document data was modified, the document has been tampered with, and so on. If this is the case, you need to make a decision regarding the applicant on the basis of the rest data in the profile. `RETRY` — temporary rejection in case of minor violations. For example, a screenshot was uploaded instead of a photo, part of the document is not visible, and so on. The applicant is sent a resubmission request to upload a new image. For more details, see Temporary rejection and Final rejection clarification.
`buttonIds`	Array of strings	List of button IDs that have been used for rejection. A specific buttonId is automatically assigned to each rejection. For more details, see Temporary rejection d Final rejection clarification.

Response example

{
  "items": [
    {
      "id": "393800000",
      "previewId": "1264200000",
      "addedDate": "2024-10-01 16:31:51",
      "fileMetadata": {
        "fileName": "docapture_manual_front_side.jpg",
        "fileType": "jpeg",
        "fileSize": 255588,
        "resolution": {
          "width": 1280,
          "height": 720
        }
      },
      "idDocDef": {
        "country": "PRT",
        "idDocType": "DRIVERS",
        "idDocSubType": "FRONT_SIDE"
      },
      "reviewResult": {
        "moderationComment": "The required fields of the document are not readable. Please upload a clear photo or another suitable document to continue your verification . Make sure that all corners of the document are visible.",
        "clientComment": "Required fields of the document are not readable or visible. A new photo has been requested.",
        "reviewAnswer": "RED",
        "rejectLabels": [
          "UNSATISFACTORY_PHOTOS"
        ],
        "reviewRejectType": "RETRY",
        "buttonIds": [
          "badPhoto_dataNotVisible"
        ]
      },
      "attemptId": "eaHEj",
      "source": "docapture"
    },
    {
      "id": "931822222",
      "previewId": "1023422222",
      "addedDate": "2024-10-01 16:31:51",
      "fileMetadata": {
        "fileName": "docapture_manual_back_side.jpg",
        "fileType": "jpeg",
        "fileSize": 209354,
        "resolution": {
          "width": 1280,
          "height": 720
        }
      },
      "idDocDef": {
        "country": "PRT",
        "idDocType": "DRIVERS",
        "idDocSubType": "BACK_SIDE"
      },
      "reviewResult": {
        "moderationComment": "The required fields of the document are not readable. Please upload a clear photo or another suitable document to continue your verification . Make sure that all corners of the document are visible.",
        "clientComment": "Required fields of the document are not readable or visible. A new photo has been requested.",
        "reviewAnswer": "RED",
        "rejectLabels": [
          "UNSATISFACTORY_PHOTOS"
        ],
        "reviewRejectType": "RETRY",
        "buttonIds": [
          "badPhoto_dataNotVisible"
        ]
      },
      "attemptId": "eaHEj",
      "source": "docapture"
    }
  ],
  "totalItems": 2
}

Overview

Request example

Response explained

items element fields

fileMetadata attributes

idDocDef attributes

reviewResult attributes

Response example

`items` element fields

`fileMetadata` attributes

`idDocDef` attributes

`reviewResult` attributes