Skip to main content

API Reference | Capacitor Document Scanner

startDocumentScanner(...)

startDocumentScanner(configuration: DocumentScannerConfiguration) => Promise<ResultWrapper<DocumentScannerResult>>
ParamType
configurationDocumentScannerConfiguration

Returns: Promise<ResultWrapper<DocumentScannerResult>>


closeDocumentScanner()

closeDocumentScanner() => Promise<void>

startFinderDocumentScanner(...)

startFinderDocumentScanner(configuration: FinderDocumentScannerConfiguration) => Promise<ResultWrapper<DocumentScannerResult>>
ParamType
configurationFinderDocumentScannerConfiguration

Returns: Promise<ResultWrapper<DocumentScannerResult>>


closeFinderDocumentScanner()

closeFinderDocumentScanner() => Promise<void>

startCroppingScreen(...)

startCroppingScreen(args: { page: Page; configuration: CroppingConfiguration; }) => Promise<ResultWrapper<CroppingResult>>
ParamType
args{ page: Page; configuration: CroppingConfiguration; }

Returns: Promise<ResultWrapper<CroppingResult>>


closeCroppingScreen()

closeCroppingScreen() => Promise<void>

startMrzScanner(...)

startMrzScanner(configuration: MrzScannerConfiguration) => Promise<ResultWrapper<MrzScannerResult>>
ParamType
configurationMrzScannerConfiguration

Returns: Promise<ResultWrapper<MrzScannerResult>>


closeMrzScanner()

closeMrzScanner() => Promise<void>

startBarcodeScanner(...)

startBarcodeScanner(configuration: BarcodeScannerConfiguration) => Promise<ResultWrapper<BarcodeScannerResult>>
ParamType
configurationBarcodeScannerConfiguration

Returns: Promise<ResultWrapper<BarcodeScannerResult>>


closeBarcodeScanner()

closeBarcodeScanner() => Promise<void>

startBatchBarcodeScanner(...)

startBatchBarcodeScanner(configuration: BatchBarcodeScannerConfiguration) => Promise<ResultWrapper<BatchBarcodeScannerResult>>
ParamType
configurationBatchBarcodeScannerConfiguration

Returns: Promise<ResultWrapper<BatchBarcodeScannerResult>>


closeBatchBarcodeScanner()

closeBatchBarcodeScanner() => Promise<void>

startEHICScanner(...)

startEHICScanner(configuration: HealthInsuranceCardScannerConfiguration) => Promise<ResultWrapper<HealthInsuranceCardScannerResult>>
ParamType
configurationHealthInsuranceCardScannerConfiguration

Returns: Promise<ResultWrapper<HealthInsuranceCardScannerResult>>


closeEHICScanner()

closeEHICScanner() => Promise<void>

startTextDataScanner(...)

startTextDataScanner(configuration: TextDataScannerConfiguration) => Promise<ResultWrapper<TextDataScannerResult>>
ParamType
configurationTextDataScannerConfiguration

Returns: Promise<ResultWrapper<TextDataScannerResult>>


closeTextDataScanner()

closeTextDataScanner() => Promise<void>

startLicensePlateScanner(...)

startLicensePlateScanner(configuration: LicensePlateScannerConfiguration) => Promise<ResultWrapper<LicensePlateScannerResult>>
ParamType
configurationLicensePlateScannerConfiguration

Returns: Promise<ResultWrapper<LicensePlateScannerResult>>


closeLicensePlateScanner()

closeLicensePlateScanner() => Promise<void>

startMedicalCertificateRecognizer(...)

startMedicalCertificateRecognizer(configuration: MedicalCertificateRecognizerConfiguration) => Promise<ResultWrapper<MedicalCertificateRecognizerResult>>
ParamType
configurationMedicalCertificateRecognizerConfiguration

Returns: Promise<ResultWrapper<MedicalCertificateScannerResult>>


closeMedicalCertificateRecognizer()

closeMedicalCertificateRecognizer() => Promise<void>

startGenericDocumentRecognizer(...)

startGenericDocumentRecognizer(configuration: GenericDocumentRecognizerConfiguration) => Promise<ResultWrapper<GenericDocumentRecognizerResult>>
ParamType
configurationGenericDocumentRecognizerConfiguration

Returns: Promise<ResultWrapper<GenericDocumentRecognizerResult>>


closeGenericDocumentRecognizer()

closeGenericDocumentRecognizer() => Promise<void>

startCheckRecognizer(...)

startCheckRecognizer(configuration: CheckRecognizerConfiguration) => Promise<ResultWrapper<CheckRecognizerResult>>
ParamType
configurationCheckRecognizerConfiguration

Returns: Promise<ResultWrapper<CheckRecognizerResult>>


closeCheckRecognizer()

closeCheckRecognizer() => Promise<void>

startVinScanner(...)

startVinScanner(configuration: VinScannerConfiguration) => Promise<ResultWrapper<VinScannerResult>>
ParamType
configurationVinScannerConfiguration

Returns: Promise<ResultWrapper<VinScannerResult>>


closeVinScanner()

closeVinScanner() => Promise<void>

initializeSDK(...)

initializeSDK(options: ScanbotSdkConfiguration) => Promise<ResultWrapper<InitializeSDKResult>>

SDK Operations *

ParamType
optionsScanbotSdkConfiguration

Returns: Promise<ResultWrapper<InitializeSDKResult>>


getLicenseInfo()

getLicenseInfo() => Promise<ResultWrapper<GetLicenseInfoResult>>

Returns: Promise<ResultWrapper<GetLicenseInfoResult>>


detectBarcodesOnImage(...)

detectBarcodesOnImage(args: DetectBarcodesOnImageArguments) => Promise<ResultWrapper<DetectBarcodesOnImageResult>>
ParamType
argsDetectBarcodesOnImageArguments

Returns: Promise<ResultWrapper<DetectBarcodesOnImageResult>>


detectBarcodesOnImages(...)

detectBarcodesOnImages(args: DetectBarcodesOnImagesArguments) => Promise<ResultWrapper<DetectBarcodesOnImagesResult>>
ParamType
argsDetectBarcodesOnImagesArguments

Returns: Promise<ResultWrapper<DetectBarcodesOnImagesResult>>


applyImageFilter(...)

applyImageFilter(args: { imageFileUri: string; filter: ImageFilterType; }) => Promise<ResultWrapper<ApplyImageFilterResult>>
ParamType
args{ imageFileUri: string; filter: ImageFilterType; }

Returns: Promise<ResultWrapper<ApplyImageFilterResult>>


applyImageFilterOnPage(...)

applyImageFilterOnPage(args: { page: Page; filter: ImageFilterType; }) => Promise<ResultWrapper<ApplyImageFilterOnPageResult>>
ParamType
args{ page: Page; filter: ImageFilterType; }

Returns: Promise<ResultWrapper<ApplyImageFilterOnPageResult>>


getImageData(...)

getImageData(args: { imageFileUri: string; }) => Promise<ResultWrapper<GetImageDataResult>>
ParamType
args{ imageFileUri: string; }

Returns: Promise<ResultWrapper<GetImageDataResult>>


rotateImage(...)

rotateImage(args: { imageFileUri: string; degrees: number; }) => Promise<ResultWrapper<RotateImageResult>>
ParamType
args{ imageFileUri: string; degrees: number; }

Returns: Promise<ResultWrapper<RotateImageResult>>


createPage(...)

createPage(args: { imageUri: string; }) => Promise<ResultWrapper<CreatePageResult>>
ParamType
args{ imageUri: string; }

Returns: Promise<ResultWrapper<CreatePageResult>>


removePage(...)

removePage(args: { page: Page; }) => Promise<ResultWrapper<RemovePageResult>>
ParamType
args{ page: Page; }

Returns: Promise<ResultWrapper<RemovePageResult>>


rotatePage(...)

rotatePage(args: { page: Page; times: number; }) => Promise<ResultWrapper<RotatePageResult>>
ParamType
args{ page: Page; times: number; }

Returns: Promise<ResultWrapper<RotatePageResult>>


setDocumentImage(...)

setDocumentImage(args: { page: Page; imageFileUri: string; }) => Promise<ResultWrapper<SetDocumentImageResult>>
ParamType
args{ page: Page; imageFileUri: string; }

Returns: Promise<ResultWrapper<SetDocumentImageResult>>


detectDocument(...)

detectDocument(args: { imageFileUri: string; }) => Promise<ResultWrapper<DetectDocumentResult>>
ParamType
args{ imageFileUri: string; }

Returns: Promise<ResultWrapper<DetectDocumentResult>>


detectDocumentOnPage(...)

detectDocumentOnPage(args: { page: Page; }) => Promise<ResultWrapper<DetectDocumentOnPageResult>>
ParamType
args{ page: Page; }

Returns: Promise<ResultWrapper<DetectDocumentOnPageResult>>


documentQualityAnalyzer(...)

documentQualityAnalyzer(args: { imageFileUri: string; imageSizeLimit?: number; }) => Promise<ResultWrapper<DocumentQualityAnalyzerResult>>
ParamType
args{ imageFileUri: string; imageSizeLimit?: number; }

Returns: Promise<ResultWrapper<DocumentQualityAnalyzerResult>>


extractImagesFromPdf(...)

extractImagesFromPdf(args: ExtractImagesFromPdfArguments) => Promise<ResultWrapper<ExtractImagesFromPdfResult>>
ParamType
argsExtractImagesFromPdfArguments

Returns: Promise<ResultWrapper<ExtractImagesFromPdfResult>>


extractPagesFromPdf(...)

extractPagesFromPdf(args: ExtractPagesFromPdfArguments) => Promise<ResultWrapper<ExtractPagesFromPdfResult>>
ParamType
argsExtractPagesFromPdfArguments

Returns: Promise<ResultWrapper<ExtractPagesFromPdfResult>>


recognizeCheck(...)

recognizeCheck(args: { imageFileUri: string; acceptedCheckStandards?: CheckStandard[]; }) => Promise<ResultWrapper<RecognizeCheckResult>>
ParamType
args{ imageFileUri: string; acceptedCheckStandards?: CheckStandard[]; }

Returns: Promise<ResultWrapper<RecognizeCheckResult>>


recognizeMrz(...)

recognizeMrz(args: { imageFileUri: string; }) => Promise<ResultWrapper<RecognizeMRZResult>>
ParamType
args{ imageFileUri: string; }

Returns: Promise<ResultWrapper<RecognizeMRZResult>>


refreshImageUris(...)

refreshImageUris(args: { pages: Page[]; }) => Promise<ResultWrapper<RefreshImageUrisResult>>
ParamType
args{ pages: Page[]; }

Returns: Promise<ResultWrapper<RefreshImageUrisResult>>


getOCRConfigs()

getOCRConfigs() => Promise<ResultWrapper<GetOCRConfigsResult>>

Returns: Promise<ResultWrapper<GetOCRConfigsResult>>


cleanup()

cleanup() => Promise<ResultWrapper<void>>

Returns: Promise<ResultWrapper<void>>


getFilteredDocumentPreviewUri(...)

getFilteredDocumentPreviewUri(args: { page: Page; filter: ImageFilterType; }) => Promise<ResultWrapper<GetFilteredDocumentPreviewUriResult>>
ParamType
args{ page: Page; filter: ImageFilterType; }

Returns: Promise<ResultWrapper<GetFilteredDocumentPreviewUriResult>>


performOCR(...)

performOCR(args: PerformOCRArguments) => Promise<ResultWrapper<PerformOCRResult>>
ParamType
argsPerformOCRArguments

Returns: Promise<ResultWrapper<PerformOCRResult>>


createPDF(...)

createPDF(args: CreatePDFArguments) => Promise<ResultWrapper<CreatePDFResult>>
ParamType
argsCreatePDFArguments

Returns: Promise<ResultWrapper<CreatePDFResult>>


writeTIFF(...)

writeTIFF(args: WriteTIFFArguments) => Promise<ResultWrapper<WriteTIFFResult>>
ParamType
argsWriteTIFFArguments

Returns: Promise<ResultWrapper<WriteTIFFResult>>


Interfaces

DocumentScannerResult

PropTypeDescription
pagesPage[]The array of scanned pages

Page

SDK Page

PropTypeDescription
pageIdstringA string identifying the page in the internal page file storage
polygonPolygonPoint[]The page's cropping polygon as calculated by a document detection operation or as set by the cropping UI. Modifying the polygon will change the polygon as shown in the cropping UI but will not automatically re-crop the original image
detectionResultDetectionStatusThe document detection result status for the operation that produced the page
pageImageSourcePageImageSourceThe image source
filterImageFilterTypeThe Image Filter that was applied on the page image
documentImageSizeLimitSizeThe value that was set for documentImageSizeLimit, which limits the maximum size of the document image.
originalImageFileUristringFile URI of the original image
documentImageFileUristringFile URI of the cropped document image (if document detection was successful)
originalPreviewImageFileUristringFile URI of a screen-sized preview of the original image
documentPreviewImageFileUristringFile URI of a screen-sized preview of the document image (if document detection was successful)

PolygonPoint

Polygon Point

PropTypeDescription
xnumberPolygon point X
ynumberPolygon point Y

Size

Standard size object

PropTypeDescription
widthnumberWidth parameter
heightnumberHeight parameter

DocumentScannerConfiguration

PropTypeDescription
acceptedAngleScorenumberThe minimum score in percent (0 - 100) of the perspective distortion to accept a detected document. Default is 75.0.
acceptedSizeScorenumberThe minimum document width or height in percent (0 - 100) of the screen size to accept a detected document. Default is 80.0.
autoSnappingButtonHiddenbooleanControls whether the auto-snapping toggle button is hidden or not.
autoSnappingButtonTitlestringTitle of the auto-snapping toggle button.
autoSnappingEnabledbooleanWhen auto-snapping is enabled the document scanner will take a photo automatically when a document is detected, conditions are good and the auto-snapping time-out elapses. In this mode the user can still tap the shutter button to snap a document.
autoSnappingSensitivitynumberControls the auto-snapping speed. Sensitivity must be within the 0..1 range. A value of 1.0 triggers automatic capturing immediately, a value of 0.0 delays the automatic by 3 seconds. The default value is 0.66 (2 seconds)
autoSnappingDelaynumberThe minimum delay in seconds between two consecutive automatic image captures. iOS only.
bottomBarBackgroundColorstringThe background color of the bottom shutter-bar.
bottomBarButtonsColorstringThe color of the title of all buttons in the bottom shutter-bar (Cancel button, etc.), as well as the camera permission prompt button.
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraBackgroundColorstringThe color of the camera background (relevant only when the camera preview mode is CameraPreviewMode.FIT_IN).
cameraPreviewModeCameraPreviewModePreview mode of the camera. Fit-In or Fill-In.
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
cameraUnavailableExplanationTextstringString being displayed on the label describing that the app is in split mode and needs to go fullscreen to work with camera. iOS only.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
cancelButtonTitlestringTitle of the cancel button.
defaultPageFilterImageFilterTypeThe default image filter type for new documents pages. Defaults to ImageFilterTypeNone.
detectorModeDocumentDetectorModeThe mode of the document detector to be used for document outline detection. Defaults to ML_BASED. iOS only. For Android, use the Scanbot SDK initializer.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not.
flashButtonTitlestringTitle of the flash toggle button.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
forceUserGuidancebooleanShows the user guidance elements if autosnapping is disabled.
ignoreBadAspectRatiobooleanSets whether to ignore the OK_BUT_BAD_ASPECT_RATIO detection status. By default BadAspectRatio is not ignored.
imageScalenumberThe image scaling factor. The factor must be within the 0..1 range. A factor of 1 means that the resulting images retain their original size. When the factor is less than 1, resulting images will be made smaller by that factor. By default the scale is 1.
multiPageButtonHiddenbooleanControls whether the multi-page toggle button is hidden or not.
multiPageButtonTitlestringTitle of the multi-page mode toggle button.
multiPageEnabledbooleanControls multi-page mode. When enabled, the user can take multiple document photos before closing the screen by tapping the page counter button. When disabled, the screen will be closed immediately after the first document photo is made. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
pageCounterButtonTitlestringTitle suffix of the button that finishes the document scanning when multi-page scanning is enabled. The button's title has the format "# Pages", where '#' shows the number of images captured up to now and the suffix "Pages" is set using this method.
photoQualityPrioritizationCapturePhotoQualityPrioritizationThe prioritization of still image quality and capturing speed. Defaults to CapturePhotoQualityPrioritization.BALANCED. If you experience lots of blurry still images try to set this property to CapturePhotoQualityPrioritization.QUALITY. Note: Has no effect on devices prior to iOS 13.0!. iOS only.
polygonBackgroundColorstringThe background color of the detected document outline when the document's angle, size or aspect ratio is not yet sufficiently good. (All net.doo.snap.lib.detector.DetectionResult with OK_BUT_XXX).
polygonBackgroundColorOKstringThe background color of the detected document outline when we are ready to snap OK.
polygonColorstringThe color of the detected document outline when the document's angle, size or aspect ratio is not yet sufficiently good. (All detection statuses in net.doo.snap.lib.detector.DetectionResult that have the OK_BUT_XXX prefix).
polygonColorOKstringThe color of the detected document outline when we are ready to snap OK.
polygonLineWidthnumberWidth of the detected document outline.
polygonCornerRadiusnumberThe radius to use when drawing rounded corners of the polygon. Default is 8.0.
polygonAutoSnapProgressColorstringStroke color of polygon auto snap progress animation. Default is green. Can't be nil.
polygonAutoSnapProgressLineWidthnumberLine width of polygon auto snap progress animation. Default is 5.0.
polygonAutoSnapProgressEnabledbooleanWhether polygon auto snap progress animation is enabled or not. Default is true.
requiredAspectRatiosAspectRatio[]An optional array of aspect ratios the documents have to conform to.
preferredAspectRatiosAspectRatio[]An optional array of aspect ratios the documents may conform to.
shutterButtonAutoInnerColorstringWhether polygon auto snap progress animation is enabled or not. Default is true.
shutterButtonAutoOuterColorstringThe background color of the shutter button in auto-snapping mode.
shutterButtonIndicatorColorstringThe indicator color of the shutter button in auto-snapping mode. iOS only.
shutterButtonManualInnerColorstringThe foreground color of the shutter button in manual mode.
shutterButtonManualOuterColorstringThe background color of the shutter button in manual mode.
stopsCameraSessionWhenDisappearedbooleanThe camera session will be stopped entirely, when the receiver disappears and restarts when the receiver reappears if set to True else will pause the delivery of video frames and QR Codes. Defaults to True. iOS only.
textHintBadAnglesstringText hint that will be shown when the current detection status is OK_BUT_BAD_ANGLES
textHintBadAspectRatiostringText hint that will be shown when the current detection status is OK_BUT_BAD_ASPECT_RATIO
textHintNothingDetectedstringText hint that will be shown when the current detection status is ERROR_NOTHING_DETECTED
textHintOffCenterstringThe text being displayed on the user-guidance label, when a document was detected, but its center is too far away from the image center.
textHintOKstringText hint that will be shown when the current detection status is OK
textHintTooDarkstringText hint that will be shown when the current detection status is ERROR_TOO_DARK
textHintTooNoisystringText hint that will be shown when the current detection status is ERROR_TOO_NOISY
textHintTooSmallstringText hint that will be shown when the current detection status is OK_BUT_TOO_SMALL
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
userGuidanceBackgroundColorstringThe background color of the user guidance hints.
userGuidanceTextColorstringThe text color of the user guidance hints.
userGuidanceFontSizenumberFont size of the user guidance. Default is 17.0.
documentImageSizeLimitSizeLimits the maximum size of the document image. If width or height are zero, this property is effectively ignored.
shutterButtonHiddenbooleanHides the shutter button if set to TRUE. Shows it otherwise. Defaults to FALSE. If set to TRUE, auto-snapping is enabled and the property autoSnappingEnabled of the behaviour configuration will have no effect. Also the auto-snapping button will be hidden.
textHintEnergySavingActivestringThe text being displayed on the user-guidance label, when the scanners energy saver is activated. iOS only.
maxNumberOfPagesnumberMaximum number of pages to scan. Ignored when set to null, or when multiPageEnabled is FALSE. Default value is null.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
accessibilityConfigurationDocumentScannerAccessibilityConfigurationAllows you to customize the accessibility configuration for the Document Scanner UI

AspectRatio

Finder aspect ratio

PropTypeDescription
widthnumberThe width component of the aspect ratio.
heightnumberThe height component of the aspect ratio.

DocumentScannerAccessibilityConfiguration

Document scanner accessibility configuration

PropTypeDescription
flashButtonAccessibilityLabelstringText, that is used as an accessibility label for the flash button.
flashButtonAccessibilityHintstringText, that is used as an accessibility hint for the flash button.
multiPageButtonAccessibilityLabelstringText, that is used as an accessibility label for the multi-page button.
multiPageButtonAccessibilityHintstringText, that is used as an accessibility hint for the multi-page button.
autoSnappingButtonAccessibilityLabelstringText, that is used as an accessibility label for the auto-snapping button.
autoSnappingButtonAccessibilityHintstringText, that is used as an accessibility hint for the auto-snapping button.
cancelButtonAccessibilityLabelstringText, that is used as an accessibility label for the cancel button.
cancelButtonAccessibilityHintstringText, that is used as an accessibility hint for the cancel button.
pageCounterButtonAccessibilityLabelstringText, that is used as an accessibility label for the page-amount button.
pageCounterAccessibilityHintstringText, that is used as an accessibility hint for the page-amount button.
shutterButtonAccessibilityLabelstringText, that is used as an accessibility label for the shutter button.
shutterButtonAccessibilityHintstringText, that is used as an accessibility hint for the shutter button.

FinderDocumentScannerConfiguration

PropTypeDescription
acceptedAngleScorenumberThe minimum score in percent (0 - 100) of the perspective distortion to accept a detected document. Default is 75.0.
acceptedSizeScorenumberThe minimum document width or height in percent (0 - 100) of the screen size to accept a detected document. Default is 80.0.
autoSnappingEnabledbooleanWhen auto-snapping is enabled the document scanner will take a photo automatically when a document is detected, conditions are good and the auto-snapping time-out elapses. In this mode the user can still tap the shutter button to snap a document.
autoSnappingSensitivitynumberControls the auto-snapping speed. Sensitivity must be within the 0..1 range. A value of 1.0 triggers automatic capturing immediately, a value of 0.0 delays the automatic by 3 seconds. The default value is 0.66 (2 seconds)
autoSnappingDelaynumberThe minimum delay in seconds between two consecutive automatic image captures. iOS only.
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraBackgroundColorstringThe color of the camera background (relevant only when the camera preview mode is CameraPreviewMode.FIT_IN).
cameraPreviewModeCameraPreviewModePreview mode of the camera. Fit-In or Fill-In.
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
cameraUnavailableExplanationTextstringString being displayed on the label describing that the app is in split mode and needs to go fullscreen to work with camera. iOS only.
cancelButtonTitlestringTitle of the cancel button.
defaultPageFilterImageFilterTypeThe default image filter type for new documents pages. Defaults to ImageFilterTypeNone.
detectorModeDocumentDetectorModeThe mode of the document detector to be used for document outline detection. Defaults to ML_BASED. iOS only. For Android, use the Scanbot SDK initializer.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
forceUserGuidancebooleanShows the user guidance elements if autosnapping is disabled.
finderEnabledbooleanEnables the view finder.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
cameraOverlayColorstringBackground color outside of the finder window.
finderAspectRatioAspectRatioAspect ratio of finder frame (width \ height), which is used to build actual finder frame. Default is the DIN A4 aspect ratio.
ignoreBadAspectRatiobooleanSets whether to ignore the OK_BUT_BAD_ASPECT_RATIO detection status. By default BadAspectRatio is not ignored.
imageScalenumberThe image scaling factor. The factor must be within the 0..1 range. A factor of 1 means that the resulting images retain their original size. When the factor is less than 1, resulting images will be made smaller by that factor. By default the scale is 1.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
photoQualityPrioritizationCapturePhotoQualityPrioritizationThe prioritization of still image quality and capturing speed. Defaults to CapturePhotoQualityPrioritization.BALANCED. If you experience lots of blurry still images try to set this property to CapturePhotoQualityPrioritization.QUALITY. Note: Has no effect on devices prior to iOS 13.0!.
polygonEnabledbooleanEnables the displaying of the documents polygon.
polygonBackgroundColorstringThe background color of the detected document outline when the document's angle, size or aspect ratio is not yet sufficiently good. (All net.doo.snap.lib.detector.DetectionResult with OK_BUT_XXX).
polygonBackgroundColorOKstringThe background color of the detected document outline when we are ready to snap OK.
polygonColorstringThe color of the detected document outline when the document's angle, size or aspect ratio is not yet sufficiently good. (All detection statuses in net.doo.snap.lib.detector.DetectionResult that have the OK_BUT_XXX prefix).
polygonColorOKstringThe color of the detected document outline when we are ready to snap OK.
polygonLineWidthnumberWidth of the detected document outline.
polygonCornerRadiusnumberThe radius to use when drawing rounded corners of the polygon. Default is 8.0.
autoSnapProgressColorstringStroke color of polygon or finder auto snap progress animation. Default is green. Can't be nil.
autoSnapProgressLineWidthnumberLine width of polygon or finder auto snap progress animation. Default is 5.0.
autoSnapProgressEnabledbooleanWhether polygon or finder auto snap progress animation is enabled or not. Default is true.
lockDocumentAspectRatioToFinderbooleanIf true allows only scanning of documents with the aspect ratio that the finder has.
shutterButtonAutoInnerColorstringWhether polygon auto snap progress animation is enabled or not. Default is true.
shutterButtonAutoOuterColorstringThe background color of the shutter button in auto-snapping mode.
shutterButtonIndicatorColorstringThe indicator color of the shutter button in auto-snapping mode. iOS only.
shutterButtonManualInnerColorstringThe foreground color of the shutter button in manual mode.
shutterButtonManualOuterColorstringThe background color of the shutter button in manual mode.
stopsCameraSessionWhenDisappearedbooleanThe camera session will be stopped entirely, when the receiver disappears and restarts when the receiver reappears if set to True else will pause the delivery of video frames and QR Codes. Defaults to True. iOS only.
textHintBadAnglesstringText hint that will be shown when the current detection status is OK_BUT_BAD_ANGLES
textHintBadAspectRatiostringText hint that will be shown when the current detection status is OK_BUT_BAD_ASPECT_RATIO
textHintNothingDetectedstringText hint that will be shown when the current detection status is ERROR_NOTHING_DETECTED
textHintOffCenterstringThe text being displayed on the user-guidance label, when a document was detected, but its center is too far away from the image center.
textHintOKstringText hint that will be shown when the current detection status is OK
textHintTooDarkstringText hint that will be shown when the current detection status is ERROR_TOO_DARK
textHintTooNoisystringText hint that will be shown when the current detection status is ERROR_TOO_NOISY
textHintTooSmallstringText hint that will be shown when the current detection status is OK_BUT_TOO_SMALL
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
userGuidanceBackgroundColorstringThe background color of the user guidance hints.
userGuidanceTextColorstringThe text color of the user guidance hints.
userGuidanceFontSizenumberFont size of the user guidance. Default is 17.0.
documentImageSizeLimitSizeLimits the maximum size of the document image. If width or height are zero, this property is effectively ignored.
shutterButtonHiddenbooleanHides the shutter button if set to TRUE. Shows it otherwise. Defaults to TRUE. If set to TRUE, auto-snapping is enabled and the property autoSnappingEnabled of the behaviour configuration will have no effect. Also the auto-snapping button will be hidden.
textHintEnergySavingActivestringThe text being displayed on the user-guidance label, when the scanners energy saver is activated. iOS only.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
accessibilityConfigurationFinderDocumentScannerAccessibilityConfigurationAllows you to customize the accessibility configuration for the Document Scanner UI

FinderDocumentScannerAccessibilityConfiguration

Finder Document scanner accessibility configuration

PropTypeDescription
flashButtonAccessibilityLabelstringText, that is used as an accessibility label for the flash button.
flashButtonAccessibilityHintstringText, that is used as an accessibility hint for the flash button.
cancelButtonAccessibilityLabelstringText, that is used as an accessibility label for the cancel button.
cancelButtonAccessibilityHintstringText, that is used as an accessibility hint for the cancel button.
shutterButtonAccessibilityLabelstringText, that is used as an accessibility label for the shutter button.
shutterButtonAccessibilityHintstringText, that is used as an accessibility hint for the shutter button.

CroppingResult

PropTypeDescription
pagePageThe cropped page

CroppingConfiguration

PropTypeDescription
cancelButtonTitlestringTitle of the cancel button.
hintTitlestringText of the edit screen hint.
hintTitleColorstringColor of the edit screen hint text.
backgroundColorstringBackground color of the screen.
rotateButtonTitlestringTitle of the Rotate button.
resetButtonTitlestringTitle of the Reset button.
detectButtonTitlestringTitle of the Detect button.
doneButtonTitlestringTitle of the Done button.
rotateButtonHiddenbooleanChanges the visibility of the Rotate button.
detectResetButtonHiddenbooleanChanges the visibility of Detect and Reset buttons.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
polygonColorstringDefault color of the cropping outline.
anchorPointsColorstringDefault color of the cropping draggable elements.
polygonColorMagneticstringOutline color of magnetically snapped edges.
polygonLineWidthnumberWidth of the detected document outline.
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
bottomBarBackgroundColorstringThe background color of the bottom shutter-bar.
bottomBarButtonsColorstringThe color of the title of all buttons in the bottom shutter-bar (Cancel button, etc.), as well as the camera permission prompt button.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
swapTopBottomButtonsbooleanSwap top and bottom buttons on the screen
topBarTitlestringThe title of the Cropping UI Screen. iOS only
topBarTitleColorstringThe color of the title. iOS only
accessibilityConfigurationCroppingAccessibilityConfigurationAllows you to customize the accessibility configuration for the Cropping UI

CroppingAccessibilityConfiguration

Cropping screen accessibility configuration

PropTypeDescription
cancelButtonAccessibilityLabelstringText, that is used as an accessibility label for the cancel button
cancelButtonAccessibilityHintstringText, that is used as an accessibility hint for the cancel button
doneButtonAccessibilityLabelstringText, that is used as an accessibility label for the done button
doneButtonAccessibilityHintstringText, that is used as an accessibility hint for the done button.
detectButtonAccessibilityLabelstringText, that is used as an accessibility label for the detect button
detectButtonAccessibilityHintstringText, that is used as an accessibility hint for the detect button
resetButtonAccessibilityLabelstringText, that is used as an accessibility label for the reset button
resetButtonAccessibilityHintstringText, that is used as an accessibility hint for the reset button
rotateButtonAccessibilityLabelstringText, that is used as an accessibility hint for the rotate button
rotateButtonAccessibilityHintstringText, that is used as an accessibility hint for the rotate button

MrzScannerResult

MrzScannerConfiguration

PropTypeDescription
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintstringString being displayed as description.
finderTextHintColorstringForeground color of the description label.
finderAspectRatioAspectRatioAspect ratio of finder frame (width \ height), which is used to build actual finder frame. Default is 7 - which is good for standard machine readable zones.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
successBeepEnabledbooleanControls whether to play a beep sound after a successful detection. Default value is TRUE.
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.

BarcodeScannerResult

PropTypeDescription
barcodesBarcodeResultField[]The array of detected barcodes

BarcodeResultField

The Barcode Scanner Result Field

PropTypeDescription
typeBarcodeFormatThe recognized barcode type
textstringThe recognized barcode text
textWithExtensionstringThe recognized barcode text with extension (if available)
rawBytesnumber[]The array of raw bytes that compose the recognized barcode
parsedSuccessfulbooleanTrue if the Barcode Document has been parsed successfully
formattedResultAAMVADocumentFormat | BoardingPassDocumentFormat | GS1DocumentFormat | IDCardPDF417DocumentFormat | MedicalCertificateDocumentFormat | MedicalPlanDocumentFormat | SEPADocumentFormat | SwissQRCodeDocumentFormat | VCardDocumentFormatThe formatted barcode document (if it was parsed succesfully)

AAMVADocumentFormat

AAMVA Document Format

PropTypeDescription
headerRawStringstringHeader Raw String
fileTypestringFile Type
issuerIdentificationNumberstringIssuer Identification Number
aamvaVersionNumberstringAAMVA Version Number
jurisdictionVersionNumberstringJurisdiction Version Number
numberOfEntriesnumberNumber of entries
subfilesAAMVADocumentSubfile[]Sub-files

AAMVADocumentSubfile

AAMVA Document Sub-File

PropTypeDescription
subFileTypestringSub-file type
subFileRawHeaderstringSub-file raw header
fieldsAAMVADocumentSubfileField[]Sub-file fields

AAMVADocumentSubfileField

AAMVA Document Sub-File Field

PropTypeDescription
typeAAMVARecordFieldTypeAAMVA Document sub-file Record Field Type
typeStringstringAAMVA Document sub-file Field Type String
valuestringAAMVA Document sub-file Field value
rawValuestringAAMVA Document sub-file Field raw value

BoardingPassDocumentFormat

Boarding Pass Document Format

PropTypeDescription
numberOfLegsnumberNumber of legs
electronicTicketbooleanTrue if electronic ticket, false otherwise
securityDatastringSecurity Data
legsBoardingPassLeg[]Legs

BoardingPassLeg

Boarding Pass Leg

PropTypeDescription
fieldsBoardingPassLegField[]Boarding Pass Leg Fields

BoardingPassLegField

Boarding Pass Leg Field

PropTypeDescription
typeBoardingPassDocumentFieldTypeBoarding Pass Document Field Type
valuestringBoarding Pass Document Field Value

GS1DocumentFormat

GS1 Document Format

PropTypeDescription
fieldsGS1DocumentField[]GS1 Document fields

GS1DocumentField

GS1 Document Field

PropTypeDescription
rawValuestringField raw value
applicationIdentifierstringApplication Identifier
dataTitlestringData Title
fieldDescriptionstringField description
standardbooleanTrue if it is standard, false otherwise
validationStatusGS1SystemElementValidationStatusValidation Status

IDCardPDF417DocumentFormat

ID Card PDF417 Document Format

PropTypeDescription
fieldsIDCardPDF417DocumentField[]ID Card PDF417 Document Fields

IDCardPDF417DocumentField

ID Card PDF417 Document Field

PropTypeDescription
typeIDCardPDF417DocumentFieldTypeField Type
valuestringField Value

MedicalCertificateDocumentFormat

Medical Certificate Document Format

PropTypeDescription
fieldsMedicalCertificateDocumentField[]Medical Certificate Document Fields

MedicalCertificateDocumentField

Medical Certificate Document Field

PropTypeDescription
typeMedicalCertificateDocumentFieldTypeMedical Certificate Document Field Type
valuestringMedical Certificate Document Field Value

MedicalPlanDocumentFormat

Medical Plan Document Format

PropTypeDescription
GUIDstringIdentifier
currentPagenumberCurrent page (index)
totalNumberOfPagesnumberTotal number of pages
documentVersionNumberstringDocument version number
patchVersionNumberstringPatch version number
languageCountryCodestringLanguage country code
patientMedicalPlanPatientInformationPatient Information
doctorMedicalPlanDoctorInformationDoctor Information
subheadingsMedicalPlanStandardSubheading[]Subheadings

MedicalPlanPatientInformation

Medical Plan Patient Information

PropTypeDescription
fieldsMedicalPlanPatientField[]Medical Plan Patient Fields

MedicalPlanPatientField

Medical Plan Patient Field

PropTypeDescription
typeMedicalPlanPatientFieldTypeMedical Plan Patient Field Type
valuestringMedical Plan Patient Field Value

MedicalPlanDoctorInformation

Medical Plan Doctor Information

PropTypeDescription
fieldsMedicalPlanDoctorField[]Medical Plan Doctor Information Fields

MedicalPlanDoctorField

Medical Plan Doctor Field

PropTypeDescription
typeMedicalPlanDoctorFieldTypeMedical Plan Doctor Field Type
valuestringMedical Plan Doctor Field Value

MedicalPlanStandardSubheading

Medical Plan Standard Subheading

PropTypeDescription
fieldsMedicalPlanStandardSubheadingField[]Subheading Fields
generalNotesstring[]General Notes
medicinesMedicalPlanMedicine[]Medicines
prescriptionsMedicalPlanPrescription[]Prescriptions

MedicalPlanStandardSubheadingField

Medical Plan Standard Subheading Field

PropTypeDescription
typeMedicalPlanStandardSubheadingFieldTypeMedical Plan Standard Subheading Field Type
valuestringMedical Plan Standard Subheading Field Value

MedicalPlanMedicine

Medical Plan Medicine

PropTypeDescription
fieldsMedicalPlanMedicineField[]Medical Plan Medicine Fields
substancesMedicalPlanMedicineSubstance[]Medical Plan Medicine Substances

MedicalPlanMedicineField

Medical Plan Medicine Field

PropTypeDescription
typeMedicalPlanMedicineFieldTypeMedical Plan Medicine Field Type
valuestringMedical Plan Medicine Field Value

MedicalPlanMedicineSubstance

Medical Plan Medicine Substance

PropTypeDescription
fieldsMedicalPlanMedicineSubstanceField[]Medical Plan Medicine Substance Fields

MedicalPlanMedicineSubstanceField

Medical Plan Medicine Substance Field

PropTypeDescription
typeMedicalPlanMedicineSubstanceFieldTypeMedical Plan Medicine Substance Field Type
valuestringMedical Plan Medicine Substance Field Value

MedicalPlanPrescription

Medical Plan Prescription

PropTypeDescription
fieldsMedicalPlanPrescriptionField[]Medical Plan Prescription Fields

MedicalPlanPrescriptionField

Medical Plan Prescription Field

PropTypeDescription
typeMedicalPlanPrescriptionFieldTypeMedical Plan Prescription Field Type
valuestringMedical Plan Prescription Field Value

SEPADocumentFormat

SEPA Document Format

PropTypeDescription
fieldsSEPADocumentFormatField[]SEPA Document Format Fields

SEPADocumentFormatField

SEPA Document Format Field

PropTypeDescription
typeSEPADocumentFieldTypeSEPA Document Field Type
valuestringSEPA Document Field Value

SwissQRCodeDocumentFormat

Swiss QR Code Document Format

PropTypeDescription
fieldsSwissQRCodeDocumentField[]Swiss QR Code Document Fields
versionSwissQRCodeVersionSwiss QR Code Version

SwissQRCodeDocumentField

Swiss QR Code Document Field

PropTypeDescription
typeSwissQRCodeDocumentFieldTypeSwiss QR Code Document Field Type
valuestringSwiss QR Code Document Field Value
typeHumanReadableStringstringSwiss QR Code Document Field Human-readable String

VCardDocumentFormat

vCard Document Format

PropTypeDescription
fieldsVCardDocumentFormatField[]vCard Document Format Fields

VCardDocumentFormatField

vCard Document Field

PropTypeDescription
typeVCardDocumentFormatFieldTypevCard Document Field Type
typeModifiersstring[]vCard Document Field Type Modifiers
rawTextstringvCard Document Field Raw Text
valuesstring[]vCard Document Field Values

BarcodeScannerConfiguration

PropTypeDescription
acceptedDocumentFormatsBarcodeDocumentFormat[]An optional array of barcode document formats that act as a detection filter. By default all supported document formats will be detected.
barcodesExtensionFilterBarcodesExtensionFilterThe extension filter for EAN and UPC barcodes.
barcodeValueFilterstringFilter barcodes results by regular expression. To accept scanned barcode, regular expression should match the entire barcode value. By default, no filter is applied
cameraOverlayColorstringBackground color of the detection overlay.
cameraModuleCameraModuleBackground color of the detection overlay.
cameraZoomFactornumberThe relative initial zoom level of the camera in the range (0,1), where 0 is zoomed out and 1 is zoomed in. Default value is 0.0.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
cancelButtonTitlestringString being displayed on the cancel button.
engineModeEngineModeThe engine mode to be used for barcode scanning. The default value is NEXT_GEN.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintstringString being displayed as description.
finderTextHintColorstringForeground color of the description label.
finderAspectRatioAspectRatioAspect ratio of finder frame (width \ height), which is used to build actual finder frame. Default is 1 - it is a square frame, which is good for QR capturing.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringString being displayed on the flash button. iOS only.
flashButtonInactiveColorstringForeground color of the flash button when flash is off.
flashEnabledbooleanWhether flash is toggled on or off.
focusLockEnabledbooleanDisables auto-focus and locks the lens at the specified focus lock lens position. Default value is false. iOS only. For Android, minFocusDistanceLock can be used.
focusLockPositionnumberThe position of the lens. Values can be between 0.0f (minimum focusing distance) and 1.0f (maximum focusing distance). The default value is 0.0 iOS only. For Android, minFocusDistanceLock can be used.
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
minimumTextLengthnumberOptional minimum required text length of the detected barcode. The default is 0 (setting is turned off). NOTE - This feature works on ITF barcodes only.
maximumTextLengthnumberOptional maximum text length of the detected barcode. The default is 0 (setting is turned off). NOTE - This feature works on ITF barcodes only.
minFocusDistanceLockbooleanLock focus distance withing minimum possible range
minimum1DBarcodesQuietZonenumberOptional minimum required quiet zone on the barcode. Measured in modules (the size of minimal bar on the barcode). The default is 10. NOTE - This feature works on ITF barcodes only.
stripCheckDigitsbooleanWith this option enabled, the scanner removes checks digits for UPC, EAN and MSI Plessey codes. Has no effect if both single and double digit MSI Plessey checksums are enabled. The default is false
successBeepEnabledbooleanWhether scanner screen should make a sound on successful barcode or MRZ detection.
topBarBackgroundColorstringBackground color of the top bar.
topBarButtonsColorstringForeground color of the cancel button.
barcodeFormatsBarcodeFormat[]Accepted barcode formats
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
cameraZoomRangeZoomRangeThe range of valid camera zoom factors. Default value is (1.0; 12.0).
autoCancelTimeoutnumberSets auto close timer in seconds. 0 = disabled and it is the default value.
gs1HandlingModeGs1HandlingModeThe GS1 handling mode. The default value is PARSE.
msiPlesseyChecksumAlgorithmMSIPlesseyChecksumAlgorithmThe checksum algorithm for MSI Plessey barcodes. The default value is MOD_10.
lowPowerModebooleanIf true, enabled the mode which slightly decreases the scanning quality and the energy consumption, and increases the scanning speed. If false - mode is disabled. The default is false. Android only.
codeDensityCodeDensityThe expected density of QR codes in an image.
initialScanDelaynumberScanning delay after scanner appearance in seconds. Defaults to 0 secs.
delayAfterScannumberFreezes a preview after a scan for a given amount of seconds. Defaults to 0 secs. Android only.
doubleTapToZoomEnabledbooleanWhen this property is set to true, the zoom can be activated by double tapping somewhere in the receivers view. iOS only.
pinchToZoomEnabledbooleanWhen this property is set to true, the zoom can be activated by a pinch gesture somewhere in the receivers view. iOS only.
shouldAnimateZoomingbooleanDefines, if zooming in or out should be animated. iOS only.
viewFinderEnabledbooleanDisplay the region of interest. The default value is TRUE.
confirmationDialogConfigurationConfirmationDialogConfigurationThe confirmation dialog configuration.
overlayConfigurationSelectionOverlayConfigurationThe selection overlay configuration.

ZoomRange

Defines a range for zooming

PropTypeDescription
minZoomnumberThe minimum zoom scale. Defaults to 1.0.
maxZoomnumberThe maximum zoom scale. Defaults to 12.0.

ConfirmationDialogConfiguration

Confirmation Dialog configuration

PropTypeDescription
resultWithConfirmationEnabledbooleanDefines, if the confirmation dialog should be displayed or not before returing the results to the delegate. Defaults to False.
dialogTextFormatBarcodeDialogFormatThe text format of the result dialog. Defaults to TYPE_AND_CODE.
confirmationDialogStyleDialogStyleThe style of the confirmation dialog. iOS only.
confirmButtonTitlestringThe title of the confirmation dialog confirm button.
confirmationDialogConfirmButtonStyleDialogButtonStyleThe style of the confirmation dialogs confirm button. iOS only.
retryButtonTitlestringThe title of the confirmation dialog retry button.
confirmationDialogRetryButtonStyleDialogButtonStyleThe style of the confirmation dialogs retry button. iOS only.
dialogTitlestringThe title of the confirmation dialog.
dialogMessagestringThe message text of the confirmation dialog.
dialogButtonsAccentColorstringThe accent color of buttons on a confirmation dialog. Android only.
confirmButtonFilledbooleanAllows to set if the confirm button should be filled. Defaults to TRUE. Android only.
confirmButtonFilledTextColorstringAllows to set a text color of the filled button. See confirmationDialogConfirmButtonFilled. Android only.

DialogStyle

Configuration for the dialog/alert style

PropTypeDescription
screenBackgroundColorstringThe Color of the screen-covering backdrop view.
dialogBackgroundColorstringThe general background color of the actual dialog view.
dialogBackgroundEffectBlurEffectThe visual effect of the dialogs background.
cornerRadiusnumberThe corner radius of the dialog.
titleColorstringThe color of the dialogs title.
titleFontFontThe font of the dialogs title
messageColorstringThe color of the dialogs message.
messageFontFontThe font of the dialogs message.
separatorColorstringThe color of the separators around the dialogs button area.
separatorWidthnumberThe width of the separators in points.

Font

The font name and size. iOS only.

PropTypeDescription
fontNamestringThe font name. defaults to SYSTEM.
fontSizenumberThe font size. defaults 17.0 .

DialogButtonStyle

Configuration for the dialogs/alerts OK button style.

PropTypeDescription
fontFontThe font of the button title.
textColorstringThe color of the buttons title while not pressed.
highlightedTextColorstringThe color of the buttons title while pressed.
backgroundColorstringThe background color of the button while not pressed.
highlightedBackgroundColorstringThe background color of the button while pressed.

SelectionOverlayConfiguration

Barcode Selection Overlay configuration

PropTypeDescription
overlayEnabledbooleanWhether the barcode selection overlay is enabled or not.
automaticSelectionEnabledbooleanWhether the barcode is selected automatically when being detected or not.
textFormatBarcodeOverlayTextFormatDefine the way of how to show barcode data with selection overlay.
polygonColorstringThe color of the polygon in the selection overlay.
textColorstringThe color of the text in the selection overlay.
textContainerColorstringThe color of the texts background in the selection overlay.
highlightedPolygonColorstringThe color of the polygon in the selection overlay, when highlighted.
highlightedTextColorstringThe color of the text in the selection overlay, when highlighted.
highlightedTextContainerColorstringThe color of the texts background in the selection overlay, when highlighted.

BatchBarcodeScannerResult

BatchBarcodeScannerConfiguration

PropTypeDescription
acceptedDocumentFormatsBarcodeDocumentFormat[]An optional array of barcode document formats that act as a detection filter. By default all supported document formats will be detected.
barcodesExtensionFilterBarcodesExtensionFilterThe extension filter for EAN and UPC barcodes.
barcodeValueFilterstringFilter barcodes results by regular expression. To accept scanned barcode, regular expression should match the entire barcode value. By default, no filter is applied
cameraOverlayColorstringBackground color of the detection overlay.
cameraModuleCameraModuleBackground color of the detection overlay.
cameraZoomFactornumberThe relative initial zoom level of the camera in the range (0,1), where 0 is zoomed out and 1 is zoomed in. The default value is 0.
cameraZoomRangeZoomRangeThe range of valid camera zoom factors. Default value is (0.0; 12.0). iOS only.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
cancelButtonTitlestringString being displayed on the cancel button.
doubleTapToZoomEnabledbooleanWhen this property is set to true, the zoom can be activated by double tapping somewhere in the receivers view. iOS only.
pinchToZoomEnabledbooleanWhen this property is set to true, the zoom can be activated by a pinch gesture somewhere in the receivers view. iOS only.
shouldAnimateZoomingbooleanDefines, if zooming in or out should be animated. iOS only.
engineModeEngineModeString being displayed on the cancel button.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintstringString being displayed as description.
finderTextHintColorstringForeground color of the description label.
finderAspectRatioAspectRatioAspect ratio of finder frame (width \ height), which is used to build actual finder frame. Default is 1 - it is a square frame, which is good for QR capturing.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringString being displayed on the flash button. iOS only.
flashEnabledbooleanWhether flash is toggled on or off.
focusLockEnabledbooleanDisables auto-focus and locks the lens at the specified focus lock lens position. The default value is false. iOS only.
focusLockPositionnumberThe position of the lens. Values can be between 0.0f (minimum focusing distance) and 1.0f (maximum focusing distance). The default value is 0.0 iOS only. For Android, minFocusDistanceLock can be used.
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
minimumTextLengthnumberOptional minimum required text length of the detected barcode. The default is 0 (setting is turned off). NOTE - This feature works on ITF barcodes only.
maximumTextLengthnumberOptional maximum text length of the detected barcode. The default is 0 (setting is turned off). NOTE - This feature works on ITF barcodes only.
minimum1DBarcodesQuietZonenumberOptional minimum required quiet zone on the barcode. Measured in modules (the size of minimal bar on the barcode). The default is 10. NOTE - This feature works on ITF barcodes only.
minFocusDistanceLockbooleanLock focus distance withing minimum possible range
stripCheckDigitsbooleanWith this option enabled, the scanner removes checks digits for UPC, EAN and MSI Plessey codes. Has no effect if both single and double digit MSI Plessey checksums are enabled. The default is false
successBeepEnabledbooleanWhether scanner screen should make a sound on successful barcode or MRZ detection.
topBarBackgroundColorstringBackground color of the top bar.
topBarButtonsColorstringForeground color of the cancel button.
topBarButtonsInactiveColorstringForeground color of the top bar buttons when disabled.
barcodeFormatsBarcodeFormat[]Accepted barcode formats
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
gs1HandlingModeGs1HandlingModeThe GS1 handling mode. The default value is PARSE.
msiPlesseyChecksumAlgorithmMSIPlesseyChecksumAlgorithmThe checksum algorithm for MSI Plessey barcodes. The default value is MOD_10.
lowPowerModebooleanIf true, enabled the mode which slightly decreases the scanning quality and the energy consumption, and increases the scanning speed. If false - mode is disabled. The default is false. Android only.
barcodesCountTextstringThe color for barcodes count text
barcodesCountTextColorstringThe color for barcodes count text
clearButtonTitlestringText of the button which clears the list of scanned barcodes.
detailsActionColorstringThe color of Submit button
detailsBackgroundColorstringThe color of bottom sheet
detailsPrimaryColorstringThe color of text elements in bottom sheet
deleteButtonTitlestringString being displayed on the delete button. iOS only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
fetchingStateTextstringThe text for the data fetching state of the barcode item in a list. Smth "Fetching info…"
noBarcodesTitlestringText of the message that there are no barcodes scanned
submitButtonTitlestringText of the button which finishes the flow
codeDensityCodeDensityThe expected density of QR codes in an image.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
autoCancelTimeoutnumberSets auto close timer in seconds. 0 = disabled and it is the default value. Android only
initialScanDelaynumberScanning delay after scanner appearance in seconds. Defaults to 0 secs.
viewFinderEnabledbooleanDisplay the region of interest. The default value is TRUE.
overlayConfigurationSelectionOverlayConfigurationThe selection overay configuration.

HealthInsuranceCardScannerResult

PropTypeDescription
fieldsHealthInsuranceCardField[]The array of recognized Health Insurance Card fields

HealthInsuranceCardField

The Health Insurance Card field

PropTypeDescription
typestringHealth Insurance Card Field Type
valuestringHealth Insurance Card Field Recognized Text
confidencenumberConfidence in result accuracy. The value ranges from 0 to 100, higher is better.

HealthInsuranceCardScannerConfiguration

PropTypeDescription
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
detectionStatusFailedDetectionTextstringString being displayed when health insurance card was not found.
detectionStatusFailedValidationTextstringString being displayed when health insurance card was found but not recognized.
detectionStatusSuccessTextstringString being displayed when health insurance card was found and recognized.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintstringString being displayed as description.
finderTextHintColorstringForeground color of the description label.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.

TextDataScannerResult

PropTypeDescription
resultTextDataRecognitionResultThe Text Data Scanner recognition result

TextDataRecognitionResult

The Text Data Recognition Result

PropTypeDescription
textstringThe recognized text
confidencenumberConfidence in the accuracy of the recognition (from 0 to 100)

TextDataScannerConfiguration

PropTypeDescription
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintColorstringForeground color of the description label.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
wordBoxHighlightColorstringThe color of the highlight of the wordboxes founded on the frame
wordBoxHighlightEnabledbooleanIf the wordboxes should be highlighted when were found on the frame
minimumNumberOfRequiredFramesWithEqualRecognitionResultnumberMinimum number of accumulated frames that have equal result
maximumNumberOfAccumulatedFramesnumberMaximum number of accumulated frames to inspect before actual result is returned
ocrResolutionLimitnumberThe image will be downscaled to the given value during the processing. If the quality of the scanning is not enough, try to increase the limit. This variable affects the performance of the scanning process. Higher the size limit - better the quality, but the recognition is slower. 0 - do not rescale.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
textDataScannerStepTextDataScannerStepConfiguration for the scanned item

TextDataScannerStep

Configuration for the scanned item

PropTypeDescription
guidanceTextstringUser guidance hint text.
patternstringValidation pattern to automatically validate recognized text. '?' = any character, '#' - any digit, all other characters represent themselves. An empty string or nil value will disable the validation pattern.
shouldMatchSubstringbooleanIf set to TRUE pattern validation also validates successfully if only a part of the whole recognized text matches the the validation pattern. If set to FALSE, the whole text must match the validation pattern. Applies to pattern validation only. Defaults to FALSE.
preferredZoomnumberThe cameras zoom level preferred for this step. The actual zoom might be different from the preferred one to avoid clipping of finder area and maintain its aspect ratio and height
aspectRatioAspectRatioThe cameras zoom level preferred for this step. The actual zoom might be different from the preferred one to avoid clipping of finder area and maintain its aspect ratio and height
unzoomedFinderHeightnumberThe preferred height of the finder for zoom scale 1.0 (unzoomed). The actual finder height might change to maintain aspect ratio and to not clip the screen. Defaults to 40 points.
allowedSymbolsstringA string (list) of accepted characters during text recognition. If empty or nil, all characters are accepted. Defaults to nil.
significantShakeDelaynumberThreshold used to pause the detection after significant movement occurred. Default = 0

LicensePlateScannerResult

PropTypeDescription
licensePlatestringThe License Plate detected by the scanner
confidencenumberConfidence in result accuracy. The value ranges from 0 to 100, higher is better.
countryCodestringThe Country Code on the License Plate as detected by the scanner

LicensePlateScannerConfiguration

PropTypeDescription
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
confirmationDialogStyleDialogStyleThe style of the confirmation dialog. iOS Only.
confirmationDialogConfirmButtonStyleDialogButtonStyleThe style of the confirmation dialogs confirm button. iOS Only.
confirmationDialogRetryButtonStyleDialogButtonStyleThe style of the confirmation dialogs retry button. iOS Only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintstringUser guidance text below the finder view
finderTextHintColorstringForeground color of the description label.
finderPreferredHeightnumberThe preferred height of the view finder. Defaults to 150.0. iOS only.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
minNumberOfRequiredFramesWithEqualRecognitionResultnumberMinimum number of accumulated frames that have equal result
maximumNumberOfAccumulatedFramesnumberMaximum number of accumulated frames to inspect before actual result is returned
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
significantShakeDelaynumberThreshold used to pause the detection after significant movement occurred. -1 is default value. Default = 0 for textFilterStrategy='DOCUMENT' and 1000 for textFilterStrategy='LCD_DOT_MATRIX_DISPLAY'. Android only.
scanStrategyLicensePlateScanStrategyDetector mode, classic (OCR based) or ML (machine learning based) approach.
confirmationDialogTitlestringThe title of the confirmation dialog.
confirmationDialogMessagestringThe message text of the confirmation dialog.
confirmationDialogConfirmButtonTitlestringThe title of the confirmation dialog retry button.
confirmationDialogRetryButtonTitlestringThe title of the confirmation dialog confirm button.
confirmationDialogAccentColorstringThe accent color of buttons on a confirmation dialog. Android only.
confirmationDialogConfirmButtonFilledbooleanAllows to set if the confirm button should be filled. Defaults to TRUE. Android only.
confirmationDialogConfirmButtonFilledTextColorstringAllows to set a text color of the filled button. See confirmationDialogConfirmButtonFilled. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.

MedicalCertificateRecognizerConfiguration

PropTypeDescription
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
userGuidanceBackgroundColorstringThe background color of the user guidance hints.
userGuidanceTextColorstringThe text color of the user guidance hints.
userGuidanceHiddenbooleanWhether the user guidance label is hidden or not. iOS only.
recognizePatientInfobooleanWhether sdk should run recognition of Patient Information block.
returnCroppedDocumentImagebooleanWhether sdk should return cropped document image or not
errorDialogStyleDialogStyleThe style of the dialog/alert in case of error. iOS only.
errorDialogTitlestringError dialog title
errorDialogAccentColorstringThe accent color of buttons on a error dialog.
errorDialogMessagestringError dialog message
errorDialogOkButtonstringError dialog ok button text.
errorDialogOkButtonFilledbooleanAllows to set if the confirm button should be filled. Android only.
errorDialogOkButtonFilledTextColorstringAllows to set a text color of the filled button. Android only.
errorDialogButtonStyleDialogButtonStyleThe style of the dialogs/alerts OK button in case of error. iOS only.
showFinderOverlaybooleanOption to show or hide finder overlay
userGuidanceStringsMedicalCertificateUserGuidanceStringsConfiguration that helps to override default hint values
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
finderAspectRatioAspectRatioAspect ratio of the view finder (width \ height). Set to nil of no view finder should be displayed. iOS only.
finderSecondaryAspectRatioAspectRatioSecondary aspect ratio of finder frame (width \ height). Set to nil if no secondary view finder should be displayed. iOS only.

MedicalCertificateUserGuidanceStrings

Configuration for the hint values

PropTypeDescription
startScanningstringText that is shown on camera open.
scanningstringText text that is shown when the camera is seeking for the document on the visible area, shown after the first result from the detector.
energySavingstringText text that is shown when energy saving is active.
capturingstringText that is shown when the camera snaps the image.
processingstringText that is shown when the detector tries to detect the document from the snapped image.
pausedstringText that is shown when the detector is paused. iOS only.

GenericDocumentRecognizerResult

PropType
documents(MRZDocument | DeIdCardFrontDocument | DeIdCardBackDocument | DePassportDocument | DeDriverLicenseFrontDocument | DeDriverLicenseBackDocument)[]

MRZDocument

MRZ part of the document

PropTypeDescription
unknownFieldUnknown
documentNumberFieldDocument number
issuingAuthorityFieldIssuing authority
officeOfIssuanceFieldOffice of issuance
dateOfIssuanceFieldDate of issuance
givenNamesFieldGiven names
surnameFieldSurname
nationalityFieldNationality
birthDateFieldBirth date
genderFieldGender
expiryDateFieldExpiry date
personalNumberFieldPersonal number
travelDocTypeFieldTravel document type
travelDocTypeVariantFieldTravel document type variant
optional1FieldOptional 1
optional2FieldOptional 2
documentTypeCodeFieldDocument type code
pinCodeFieldPIN code
languageCodeFieldLanguage code
versionNumberFieldVersion number
checkDigitDocumentNumberFieldCheck digit document number
checkDigitBirthDateFieldCheck digit birth date
checkDigitExpiryDateFieldCheck digit expiry date
checkDigitPersonalNumberFieldCheck digit personal number
checkDigitGeneralFieldCheck digit general

Field

Document field

PropTypeDescription
valueFieldValueOptional value of the field
validationStatusValidationStatusField validation status. Applicable only to fields that support some kind of validation.

FieldValue

Result of GDR field recognition.

PropTypeDescription
textstringRecognized text
confidencenumberConfidence in result accuracy. The value ranges from 0 to 100, higher is better.

DeIdCardFrontDocument

German ID card, front side

PropTypeDescription
idFieldDocument ID number (in the top-right corner)
surnameFieldSurname
maidenNameFieldMaiden name
givenNamesFieldGiven names
birthDateFieldBirth date
nationalityFieldNationality
birthplaceFieldBirthplace
expiryDateFieldExpiry date
pinFieldPIN
signatureFieldSignature image

DeIdCardBackDocument

German ID card, back side

PropTypeDescription
eyeColorFieldEye color
heightFieldHeight
issueDateFieldIssue date
issuingAuthorityFieldIssuing authority
addressFieldAddress
pseudonymFieldPseudonym
rawMRZFieldRaw MRZ text value
mrzMRZDocumentContains the MRZ sub-document.

DePassportDocument

German travel passport (Reisepass)

PropTypeDescription
idFieldDocument ID number (in the top-right corner)
surnameFieldSurname
maidenNameFieldMaiden name
givenNamesFieldGiven names
birthDateFieldBirth date
nationalityFieldNationality
birthplaceFieldBirthplace
expiryDateFieldExpiry date
passportTypeFieldPassport type
countryCodeFieldCountry code
genderFieldGender
signatureFieldSignature image
issueDateFieldIssue date
issuingAuthorityFieldIssuing authority
rawMRZFieldRaw MRZ text value
mrzMRZDocumentContains the MRZ sub-document.

DeDriverLicenseFrontDocument

German driver license (Führerschein), front side

PropTypeDescription
surnameFieldSurname
givenNamesFieldGiven names
birthDateFieldBirth date
birthplaceFieldBirthplace
issueDateFieldIssue date
issuingAuthorityFieldIssuing authority
expiryDateFieldExpiry date
idFieldDocument ID number (in the top-right corner)
signatureFieldSignature image
licenseCategoriesFieldDriver's license categories

DeDriverLicenseBackDocument

German driver license (Führerschein), back side

PropTypeDescription
restrictionsFieldRestrictions applied for the driver's license
categoriesCategoriesDocumentCategories table row container

CategoriesDocument

Categories table row container

PropTypeDescription
aADocumentContains the A sub-document.
a1A1DocumentContains the A1 sub-document.
a2A2DocumentContains the A2 sub-document.
bBDocumentContains the B sub-document.
b1B1DocumentContains the B1 sub-document.
beBEDocumentContains the BE sub-document.
cCDocumentContains the C sub-document.
c1C1DocumentContains the C1 sub-document.
c1eC1EDocumentContains the C1E sub-document.
ceCEDocumentContains the CE sub-document.
dDDocumentContains the D sub-document.
d1D1DocumentContains the D1 sub-document.
d1eD1EDocumentContains the D1E sub-document.
deDEDocumentContains the DE sub-document.
lLDocumentContains the L sub-document.
mMDocumentContains the M sub-document.
tTDocumentContains the T sub-document.

ADocument

The A document.

A1Document

The A1 document.

A2Document

The A2 document.

BDocument

The B document.

B1Document

The B1 document.

BEDocument

The BE document.

CDocument

The C document.

C1Document

The C1 document.

C1EDocument

The C1E document.

CEDocument

The CE document.

DDocument

The D document.

D1Document

The D1 document.

D1EDocument

The D1E document.

DEDocument

The DE document.

LDocument

The L document.

MDocument

The M document.

TDocument

The T document.

GenericDocumentRecognizerConfiguration

PropTypeDescription
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
cameraModuleCameraModuleThe preferred camera module (default - BACK)
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
cameraOverlayColorstringBackground color outside of the finder window.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
fieldsCountTextColorstringText color of the fields count label.
fieldConfidenceHighColorstringColor of confidence value label background in details screen, when the field confidence level is high.
fieldConfidenceModerateColorstringColor of confidence value label background in details screen, when the field confidence level is moderate.
fieldConfidenceLowColorstringColor of confidence value label background in details screen, when the field confidence level is low.
fieldConfidenceTextColorstringColor of confidence value label text in details.
tipTextColorstringColor of tip text on scanning screen.
tipBackgroundColorstringColor of tip background on scanning screen.
detailsBackgroundColorstringThe color of bottom sheet
detailsPrimaryColorstringThe color of text elements in bottom sheet
detailsActionColorstringThe color of Submit button
detailsSectionHeaderTextColorstringText color for section headers on the details screen. iOS only.
detailsSectionHeaderBackgroundColorstringBackground color for section headers on the details screen. iOS only.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
clearButtonTitlestringString used for displaying amount of detected fields. Use %d for number formatting symbol.
submitButtonTitlestringText of the button which finishes the flow
fieldsCountTextstringString used for displaying amount of detected fields. Use %d for number formatting symbol.
confidenceValuestringString that shows average confidence value of scanned document. Use %d as number formatting symbol.
scanBackSideTitlestringString that asks user to scan back side of a document.
scanFrontSideTitlestringString that asks user to scan front side of a document.
startScanningTitlestringString that asks user to start scanning a document.
scannedEverythingTitlestringString that notifies that both sides of document are scanned.
emptyValueTitlestringString being displayed for empty values. iOS only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
imageTitlestringA title to show image content. Android only.
noDataTitlestringString that notifies that nothing was scanned yet.
acceptedDocumentTypesGenericDocumentType[]Accepted document types. All other document types will be ignored. By default - All types
sharpnessAcceptanceFactornumberAccepted minimal sharpness score. Images with a score less than that will be rejected with RecognitionStatus::ErrorTooBlurry. Default is 80. 0 - any image will be accepted. 80 - a good compromise; the recommended setting. 100 - only very sharp images will be accepted.
fieldsDisplayConfigurationFieldsDisplayConfiguration[]Allows to configure the display configuration for fields.
documentsDisplayConfigurationDocumentsDisplayConfiguration[]Allows to configure the display configuration for documents.
excludedFieldTypesstring[]List of secure fields which should be excluded from scanning process. All other fields will be scanned as usual. Field should be set ONLY as normalized field name. Example - [DePassport.BirthDate] or [DePassport.Birthplace]
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not.
flashButtonTitlestringTitle of the flash toggle button.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.

FieldsDisplayConfiguration

Field display configuration object
PropTypeDescription
normalizedFieldNamestringComplete list of available normalized field names is available in the documentation
defaultDisplayTextstringThe display text of the field in the list
defaultDisplayStateFieldDisplayStateThe default display state of a field in the RTU UI, could be hidden by default or visible by default.

DocumentsDisplayConfiguration

Field display configuration object
PropTypeDescription
normalizedDocumentNamestringComplete list of available normalized document names is available in the documentation
defaultDisplayTextstringThe display text of the document in the list

CheckRecognizerResult

The Check Recognizer Result Field

PropTypeDescription
checkUSACheckDocument | FRACheckDocument | KWTCheckDocument | AUSCheckDocument | INDCheckDocument | ISRCheckDocument | UnknownCheckDocumentCheck Document
checkStatusCheckStatusThe status of the operation
imageFileUristringThe URI of the snapped Check Image
checkTypeCheckStandardThe type of the recognized check

USACheckDocument

A check compatible with the ASC X9 standard used in the USA

PropTypeDescription
auxiliaryOnUsFieldAuxiliary On-Us
transitNumberFieldTransit number
accountNumberFieldAccount number

FRACheckDocument

A check format commonly used in France

PropTypeDescription
chequeNumberFieldCheque number
routingNumberFieldRouting number
accountNumberFieldAccount number

KWTCheckDocument

A check format commonly used in Kuwait

PropTypeDescription
chequeNumberFieldCheque number
sortCodeFieldSort code
accountNumberFieldAccount number

AUSCheckDocument

A check compatible with the Australian Paper Clearing System cheque standard

PropTypeDescription
extraAuxDomesticFieldExtra auxiliary domestic
auxDomesticFieldAuxiliary domestic
bsbFieldBSB
accountNumberFieldAccount number
transactionCodeFieldTransaction code

INDCheckDocument

A check compatible with the CTS-2010 standard issued by the Reserve Bank of India in 2012

PropTypeDescription
serialNumberFieldSerial number
sortNumberFieldSort number
accountNumberFieldAccount number
transactionCodeFieldTransaction code

ISRCheckDocument

A check format commonly used in Israel

PropTypeDescription
chequeNumberFieldCheque number
bankNumberFieldBank number
branchNumberFieldBranch number
accountNumberFieldAccount number

UnknownCheckDocument

A check that doesn't conform to any supported standard

CheckRecognizerConfiguration

PropTypeDescription
acceptedCheckStandardsCheckStandard[]Accepted check standards. Optional, by default - all checks are accepted. With an empty list no filter is applied and all checks are accepted.
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
captureHighResolutionImagebooleanSet high-resolution Check image capturing. If set to TRUE a high-resolution photo of the check is captured to run the recognition on. Upon successful recognition the recognition result also contains a high-resolution image of the check. If set to FALSE, the video frames will be used for recognition and result image delivery. The default value is TRUE.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
errorDialogStyleDialogStyleThe style of the dialog/alert in case of error. iOS Only.
errorDialogButtonStyleDialogButtonStyleThe style of the dialogs/alerts OK button in case of error. iOS Only.
errorAlertTitlestringString being displayed as the title in the error alert that may occur when the recognition fails on captured high-resolution images. iOS only.
errorAlertMessagestringString being displayed as the message in the error alert that may occur when the recognition fails on captured high-resolution images. iOS only.
errorAlertButtonTextstringString being displayed as the button text in the error alert that may occur when the recognition fails on captured high-resolution images. iOS only.
finderAspectRatioAspectRatioAspect ratio of finder frame (width \ height), which is used to build actual finder frame. Default is 1 - it is a square frame, which is good for QR capturing.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
userGuidanceBackgroundColorstringThe background color of the user guidance hints.
userGuidanceTextColorstringThe text color of the user guidance hints.
userGuidanceStringValuesCheckUserGuidanceStringsConfiguration that helps to override default hint values.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.

CheckUserGuidanceStrings

Configuration that helps to override default hint values.

PropTypeDescription
startScanningstringText that is shown on camera open.
scanningstringText text that is shown when the camera is seeking for the document on the visible area, shown after the first result from the detector.
energySavingstringText text that is shown when energy saving is active.
capturingstringText that is shown when the camera snaps the image.
processingstringText that is shown when the detector tries to detect the document from the snapped image.

VinScannerResult

PropTypeDescription
rawTextstringThe scanned Vehicle Identification Number
confidenceValuenumberThe scanned result confidence value.
validationSuccessfulbooleanBoolean that represents a successful validation

VinScannerConfiguration

PropTypeDescription
cameraModuleCameraModuleThe preferred camera module (default - BACK)
cameraOverlayColorstringBackground color outside of the finder window.
cancelButtonTitlestringTitle of the cancel button.
cancelButtonHiddenbooleanWhether the cancel button is hidden or not. iOS only.
enableCameraButtonTitlestringTitle of the button that opens the screen where the user can allow the usage of the camera by the app.
enableCameraExplanationTextstringText that will be displayed when the app is not allowed to use the camera, prompting the user to enable the usage of the camera.
finderLineColorstringForeground color of the detection overlay.
finderLineWidthnumberWidth of finder frame border. Default is 2.
finderTextHintColorstringForeground color of the description label.
flashButtonHiddenbooleanControls whether the flash toggle button is hidden or not. iOS only.
flashButtonTitlestringTitle of the flash toggle button. iOS only.
flashEnabledbooleanControls whether the flash should be initially enabled. The default value is FALSE.
orientationLockModeOrientationLockModeUI Interface orientation lock mode
topBarBackgroundColorstringThe background color of the top toolbar.
topBarButtonsActiveColorstringThe color of all active toggle buttons in the toolbar.
topBarButtonsInactiveColorstringThe color of all inactive toggle buttons in the toolbar.
minimumNumberOfRequiredFramesWithEqualRecognitionResultnumberMinimum number of accumulated frames that have equal result
maximumNumberOfAccumulatedFramesnumberMaximum number of accumulated frames to inspect before actual result is returned
ocrResolutionLimitnumberThe image will be downscaled to the given value during the processing. If the quality of the scanning is not enough, try to increase the limit. This variable affects the performance of the scanning process. Higher the size limit - better the quality, but the recognition is slower. 0 - do not rescale. Default value is 0.
useButtonsAllCapsbooleanControls whether buttons should use all capitals style, as defined by the Android Material Design. Defaults to TRUE. Android only.
replaceCancelButtonWithIconbooleanIf true, replaces the cancel button in the top bar with a back arrow icon. The default value is FALSE. Android only.
cameraPreviewModeCameraPreviewModePreview mode of the camera. FILL_IN or FIT_IN. Default is FILL_IN. Android only
touchToFocusEnabledbooleanWhether touch-to-focus is enabled on camera preview. Enabled by default. Android only.
aspectRatioAspectRatioThe cameras zoom level preferred for this step. The actual zoom might be different from the preferred one to avoid clipping of finder area and maintain its aspect ratio and height
guidanceTextstringUser guidance hint text.
significantShakeDelaynumberThreshold used to pause the detection after significant movement occurred. Default = 0. Android only.

InitializeSDKResult

PropTypeDescription
resultstringThe result initialization message

ScanbotSdkConfiguration

PropTypeDescription
loggingEnabledbooleanOptional boolean flag to enable logging. See the "Logging" section below.
enableNativeLoggingbooleanOptional boolean flag that enables Scanbot SDK Core native logging (default is false, Android only).
licenseKeystringYour license key for the Scanbot SDK. See the "License Key" section below.
storageImageQualitynumberOptional image quality value. It defines the quality factor of JPEG images. The value must be between 1 and 100, where 100 means maximum quality and largest file size. The recommended default value is 80 which is a good compromise between image file size and document legibility.
storageImageFormatStorageImageFormatOptional image format, either 'JPG' or 'PNG'. The recommended default value is 'JPG'. Please note that 'PNG' will result in larger image files! Also, the storageImageQuality value does not apply for 'PNG'.
storageBaseDirectorystringOptional directory as file URI to override the default storage base directory of the Scanbot SDK. Refer to the section "Storage" for more details.
documentDetectorModeDocumentDetectorModeOptional mode for document detection.
fileEncryptionModeFileEncryptionModeOptional file encryption mode, 'AES128' or 'AES256'.
fileEncryptionPasswordstringOptional file encryption password. Refer to the section "Storage Encryption" for more details.
useCameraXbooleanIf set to true, Camera X will be used for the RTU-UI components (Android only). Default is true.
allowGpuAccelerationbooleanIf set to true, GPU Acceleration will be enabled for Barcode Scanner, Document Scanner and Generic Document Recognizer (Android only). Default is true.
allowXnnpackAccelerationbooleanEnables/disables XNNPACK acceleration for TensorFlow ML models, which provides highly optimized implementations of floating-point neural network operators (Android only)

GetLicenseInfoResult

PropTypeDescription
isLicenseValidbooleanTrue if the license is valid, false otherwise
licenseStatusLicenseStatusThe license status
licenseExpirationDatenumberThe license expiration date in milliseconds

DetectBarcodesOnImageResult

PropTypeDescription
barcodesBarcodeResultField[]The detected barcodes

DetectBarcodesOnImageArguments

PropTypeDescription
imageFileUristringThe input image file URI

DetectBarcodesOnImagesResult

PropTypeDescription
resultsDetectBarcodesOnImagesField[]An array for which each element has a imageUri and the list of detected barcodes

DetectBarcodesOnImagesField

Detect Barcodes On Images Result Field

PropTypeDescription
imageFileUristringThe URI of the image file the barcodes have been detected on
barcodeResultsBarcodeResultField[]The array of detected barcodes

DetectBarcodesOnImagesArguments

PropTypeDescription
imageFileUrisstring[]The input image files URIs

ApplyImageFilterResult

PropTypeDescription
imageFileUristringThe URI of the filtered image

ApplyImageFilterOnPageResult

Result of applyImageFilterOnPage

GetImageDataResult

PropTypeDescription
base64ImageDatastringThe Base 64 encoded representation of the image data

RotateImageResult

PropTypeDescription
imageFileUristringThe URI of the rotated image

CreatePageResult

Result of createPage

RemovePageResult

PropTypeDescription
operationResultstringOperation Result

RotatePageResult

Result of rotatePage

SetDocumentImageResult

Result of setDocumentImage

DetectDocumentResult

PropTypeDescription
documentImageFileUristringThe URI of the document image file, if something is detected
polygonPolygonPoint[]The array of detected polygon points, if something is detected
detectionResultDetectionStatusThe status of the detection

DetectDocumentOnPageResult

Result of detectDocumentOnPage

DocumentQualityAnalyzerResult

PropTypeDescription
resultDocumentQualityQuality of the analyzed document

ExtractImagesFromPdfResult

PropTypeDescription
imageFilesUrlsstring[]The URIs of the extracted images

ExtractImagesFromPdfArguments

ExtractPagesFromPdfResult

PropTypeDescription
pagesPage[]The extracted pages

ExtractPagesFromPdfArguments

RecognizeCheckResult

Result of recognizeCheck

RecognizeMRZResult

PropTypeDescription
recognitionSuccessfulbooleanTrue if the recognition was successful, false otherwise
documentTypeMRZDocumentTypeThe recognized document type
checkDigitsCountnumberTotal number of check digits as required by the travel document type
validCheckDigitsCountnumberNumber of successfully validated check digits.
rawStringstringThe raw string of the recognized machine readable zone.
mrzMRZDocumentMRZ Document

RefreshImageUrisResult

PropTypeDescription
pagesPage[]The refreshed pages

GetOCRConfigsResult

PropTypeDescription
languageDataPathstringThe OCR languages data path
installedLanguagesstring[]The installed OCR languages

GetFilteredDocumentPreviewUriResult

PropTypeDescription
filteredDocumentPreviewUristringThe URI of the filtered document preview image

PerformOCRResult

PropTypeDescription
plainTextstringThe OCR result as plain text
pdfFileUristringThe URI of the PDF file
jsonDataanyThe OCR result as JSON data

PerformOCRArguments

PropType
imageFileUrisstring[]
languagesstring[]
options{ outputFormat?: OCROutputFormat; engineMode?: OCREngineMode; }

CreatePDFResult

PropTypeDescription
pdfFileUristringThe URI of the generated PDF file

CreatePDFArguments

PropType
imageFileUrisstring[]
options{ pageSize?: PDFPageSize; pageOrientation?: PDFPageOrientation; metadata?: PDFMetadata; }

PDFMetadata

PropType
authorstring
creatorstring
titlestring
subjectstring
keywordsstring

WriteTIFFResult

PropTypeDescription
tiffFileUristringThe URI of the output TIFF file

WriteTIFFArguments

PropType
imageFileUrisstring[]
options{ oneBitEncoded?: boolean; dpi?: number; compression?: TIFFCompression; }

Type Aliases

ResultWrapper

status: Status & T

Status

'OK' | 'CANCELED'

DetectionStatus

Detection Status

'OK' | 'OK_BUT_TOO_SMALL' | 'OK_BUT_BAD_ANGLES' | 'OK_BUT_BAD_ASPECT_RATIO' | 'ERROR_NOTHING_DETECTED' | 'ERROR_TOO_DARK' | 'ERROR_TOO_NOISY'

PageImageSource

The page image source

'UNDEFINED' | 'MANUAL_SNAP' | 'AUTO_SNAP' | 'CAMERA_FRAME' | 'IMPORT'

ImageFilterType

The image filter types.

'NONE' | 'COLOR' | 'GRAYSCALE' | 'BINARIZED' | 'COLOR_DOCUMENT' | 'PURE_BINARIZED' | 'BACKGROUND_CLEAN' | 'BLACK_AND_WHITE' | 'OTSU_BINARIZATION' | 'DEEP_BINARIZATION' | 'EDGE_HIGHLIGHT' | 'LOW_LIGHT_BINARIZATION' | 'LOW_LIGHT_BINARIZATION_2' | 'PURE_GRAY'

CameraModule

Camera module to use

'FRONT' | 'BACK' | 'BACK_WIDEST'

CameraPreviewMode

Represents camera preview modes

'FIT_IN' | 'FILL_IN'

DocumentDetectorMode

Mode for document detection.

'ML_BASED' | 'EDGE_BASED'

OrientationLockMode

Applied interface orientation

'NONE' | 'PORTRAIT' | 'LANDSCAPE'

CapturePhotoQualityPrioritization

The prioritization of still image quality and capturing speed. Has no effect on devices prior to iOS 13.0. iOS only.

'SPEED' | 'BALANCED' | 'QUALITY'

BarcodeFormat

Barcode document format

'AZTEC' | 'CODABAR' | 'CODE_25' | 'CODE_39' | 'CODE_93' | 'CODE_128' | 'DATA_MATRIX' | 'EAN_8' | 'EAN_13' | 'ITF' | 'PDF_417' | 'QR_CODE' | 'MICRO_QR_CODE' | 'RSS_14' | 'RSS_EXPANDED' | 'UPC_A' | 'UPC_E' | 'MSI_PLESSEY' | 'IATA_2_OF_5' | 'INDUSTRIAL_2_OF_5' | 'USPS_INTELLIGENT_MAIL' | 'ROYAL_MAIL' | 'JAPAN_POST' | 'ROYAL_TNT_POST' | 'AUSTRALIA_POST' | 'DATABAR_LIMITED' | 'GS1_COMPOSITE'

AAMVARecordFieldType

AAMVA Record Field Type

'AUDIT_INFORMATION' | 'CARD_REVISION_DATE' | 'COMPLIANCE_TYPE' | 'COUNTRY_TERRITORY_OF_ISSUANCE' | 'COURT_RESTRICTION_CODE' | 'DATE_OF_BIRTH' | 'DOCUMENT_DISCRIMINATOR' | 'EYES_COLOR' | 'FAMILY_NAME' | 'FAMILY_NAME_TRUNCATION' | 'FEDERAL_COMMERCIAL_VEHICLE_CODES' | 'FIRST_NAME' | 'FIRST_NAMES_TRUNCATION' | 'FULL_NAME' | 'HAIR_COLOR' | 'HAZ_MAT_ENDORSEMENT_EXPIRY_DATE' | 'HEIGHT_IN_CM' | 'HEIGHT_IN_FEET_INCHES' | 'INVENTORY_CONTROL_NUMBER' | 'ISSUE_TIMESTAMP' | 'JURISDICTION_SPECIFIC' | 'JURISDICTION_SPECIFIC_RESTRICTION_CODE_DESCRIPTION' | 'JURISDICTION_SPECIFIC_VEHICLE_CLASSIFICATION_DESCRIPTION' | 'LAST_NAME' | 'LICENSE_CLASSIFICATION_CODE' | 'LICENSE_ENDORSEMENT_CODE' | 'LICENSE_EXPIRATION_DATE' | 'LICENSE_OR_ID_DOCUMENT_ISSUE_DATE' | 'LICENSE_OR_ID_NUMBER' | 'LICENSE_RESTRICTION_CODE' | 'LIMITED_DURATION_DOCUMENT_INDICATOR' | 'MAILING_CITY' | 'MAILING_JURISDICTION_CODE' | 'MAILING_POSTAL_CODE' | 'MAILING_STREET_ADDRESS_1' | 'MAILING_STREET_ADDRESS_2' | 'MEDICAL_INDICATOR_CODES' | 'MIDDLE_NAME_OR_INITIAL' | 'MIDDLE_NAMES_TRUNCATION' | 'NAME_PREFIX' | 'NAME_SUFFIX' | 'NON_RESIDENT_INDICATOR' | 'NUMBER_OF_DUPLICATES' | 'ORGAN_DONOR' | 'ORGAN_DONOR_INDICATOR' | 'PERMIT_CLASSIFICATION_CODE' | 'PERMIT_ENDORSEMENT_CODE' | 'PERMIT_EXPIRATION_DATE' | 'PERMIT_IDENTIFIER' | 'PERMIT_ISSUE_DATE' | 'PERMIT_RESTRICTION_CODE' | 'PHYSICAL_DESCRIPTION_WEIGHT_RANGE' | 'PLACE_OF_BIRTH' | 'PREFIX' | 'RACE_ETHNICITY' | 'RESIDENCE_CITY' | 'RESIDENCE_JURISDICTION_CODE' | 'RESIDENCE_POSTAL_CODE' | 'RESIDENCE_STREET_ADDRESS_1' | 'RESIDENCE_STREET_ADDRESS_2' | 'SEX' | 'SOCIAL_SECURITY_NUMBER' | 'STANDARD_ENDORSEMENT_CODE' | 'STANDARD_RESTRICTION_CODE' | 'STANDARD_VEHICLE_CLASSIFICATION' | 'SUFFIX' | 'UNDER_18_UNTIL' | 'UNDER_19_UNTIL' | 'UNDER_21_UNTIL' | 'UNIQUE_CUSTOMER_IDENTIFIER' | 'VETERAN_INDICATOR' | 'VIRGINIA_SPECIFIC_CLASS' | 'VIRGINIA_SPECIFIC_ENDORSEMENTS' | 'VIRGINIA_SPECIFIC_RESTRICTIONS' | 'WEIGHT_IN_KG' | 'WEIGHT_IN_LBS' | 'UNKNOWN'

BoardingPassDocumentFieldType

Boarding Pass Document Field Type

'AIRLINE_DESIGNATOR_OF_BOARDING_PASS_ISSUER' | 'AIRLINE_NUMERIC_CODE' | 'BAGGAGE_TAG_LICENSE_PLATE_NUMBERS' | 'CHECK_IN_SEQUENCE_NUMBER' | 'COMPARTMENT_CODE' | 'DATE_OF_BOARDING_PASS_ISSUANCE_JULIAN' | 'DATE_OF_FLIGHT_JULIAN' | 'DEPARTURE_AIRPORT_CODE' | 'DESTINATION_AIRPORT_CODE' | 'DOCUMENT_FORM_SERIAL_NUMBER' | 'DOCUMENT_TYPE' | 'FAST_TRACK' | 'FIRST_NON_CONSECUTIVE_BAGGAGE_TAG_LICENSE_PLATE_NUMBER' | 'FLIGHT_NUMBER' | 'FOR_INDIVIDUAL_AIRLINE_USE' | 'FREE_BAGGAGE_ALLOWANCE' | 'FREQUENT_FLYER_AIRLINE_DESIGNATOR' | 'FREQUENT_FLYER_NUMBER' | 'IDAD_INDICATOR' | 'INTERNATIONAL_DOCUMENTATION_VERIFICATION' | 'MARKETING_CARRIER_DESIGNATOR' | 'OPERATING_CARRIER_DESIGNATOR' | 'OPERATING_CARRIER_PNR_CODE' | 'PASSENGER_DESCRIPTION' | 'PASSENGER_STATUS' | 'SEAT_NUMBER' | 'SECOND_NON_CONSECUTIVE_BAGGAGE_TAG_LICENSE_PLATE_NUMBER' | 'SELECTEE_INDICATOR' | 'SOURCE_OF_BOARDING_PASS_ISSUANCE' | 'SOURCE_OF_CHECK_IN' | 'VERSION_NUMBER' | 'UNKNOWN'

GS1SystemElementValidationStatus

GS1 Element Validation Status

'VALID' | 'INVALID'

IDCardPDF417DocumentFieldType

ID Card PDF417 Document Field Type

'FIRST_NAME' | 'LAST_NAME' | 'DOCUMENT_CODE' | 'BIRTH_DATE' | 'DATE_ISSUED' | 'DATE_EXPIRED' | 'OPTIONAL_1' | 'UNKNOWN'

MedicalCertificateDocumentFieldType

Medical Certificate Document Field Type

'REQUIRES_CARE' | 'ACCIDENT' | 'INITIAL_CERTIFICATE' | 'RENEWED_CERTIFICATE' | 'WORK_ACCIDENT' | 'ASSIGNED_TO_ACCIDENT_INSURANCE_DOCTOR' | 'INCAPABLE_OF_WORK_SINCE' | 'INCAPABLE_OF_WORK_UNTIL' | 'DIAGNOSED_ON' | 'DOCUMENT_DATE' | 'BIRTH_DATE' | 'FIRST_NAME' | 'LAST_NAME' | 'DIAGNOSE' | 'HEALTH_INSURANCE_NUMBER' | 'INSURED_PERSON_NUMBER' | 'STATUS' | 'PLACE_OF_OPERATION_NUMBER' | 'DOCTOR_NUMBER' | 'UNKNOWN'

MedicalPlanPatientFieldType

Medical Plan Patient Field Type

'FIRST_NAME' | 'LAST_NAME' | 'TITLE' | 'PRE_NAME' | 'SUFFIX' | 'PATIENT_ID' | 'BIRTH_DATE' | 'GENDER' | 'WEIGHT' | 'HEIGHT' | 'CREATININE_VALUE' | 'ALLERGIES_AND_INTOLERANCES' | 'BREAST_FEEDING' | 'PREGNANT' | 'PATIENT_FREE_TEXT' | 'UNKNOWN'

MedicalPlanDoctorFieldType

Medical Plan Doctor Field Type

'ISSUER_NAME' | 'DOCTOR_NUMBER' | 'PHARMACY_ID' | 'HOSPITAL_ID' | 'STREET' | 'POSTAL_CODE' | 'PLACE' | 'TELEPHONE_NUMBER' | 'EMAIL' | 'ISSUING_DATE_AND_TIME' | 'UNKNOWN'

MedicalPlanStandardSubheadingFieldType

Medical Plan Standard Subheading Field Type

'KEY_WORDS' | 'SUBHEADING_FREE_TEXT'

MedicalPlanMedicineFieldType

Medical Plan Medicine Field Type

'PHARMACEUTICAL_NUMBER' | 'DRUG_NAME' | 'DOSAGE_FORM' | 'DOSAGE_FORM_FREE_TEXT' | 'MORNING' | 'MIDDAY' | 'EVENING' | 'NIGHT' | 'DOSAGE_FREE_TEXT' | 'DOSING_UNIT' | 'DOSING_UNIT_FREE_TEXT' | 'RELEVANT_INFO' | 'REASON_FOR_TREATMENT' | 'GENERAL_NOTES' | 'UNKNOWN'

MedicalPlanMedicineSubstanceFieldType

Medical Plan Medicine Substance Field Type

'ACTIVE_SUBSTANCE' | 'POTENCY' | 'UNKNOWN'

MedicalPlanPrescriptionFieldType

Medical Plan Prescription Field Type

'GENERAL_INFORMATION' | 'PRESCRIPTION_FREE_TEXT' | 'UNKNOWN'

SEPADocumentFieldType

SEPA Document Field Type

'SERVICE_TAG' | 'VERSION' | 'CHARACTER_SET' | 'IDENTIFICATION' | 'RECEIVER_IBAN' | 'RECEIVER_BIC' | 'RECEIVER_NAME' | 'AMOUNT' | 'PURPOSE' | 'REMITTANCE' | 'INFORMATION' | 'UNKNOWN'

SwissQRCodeDocumentFieldType

Swiss QR Code Document Field Type

'ADDITIONAL_BILLING_INFORMATION' | 'ADDITIONAL_INFO_TRAILER' | 'ADDITIONAL_INFO_UNSTRUCTURED' | 'ALTERNATIVE_PROCEDURE_PARAMETER' | 'AMOUNT' | 'CURRENCY' | 'DEBTOR_ADDRESS_TYPE' | 'DEBTOR_COUNTRY' | 'DEBTOR_NAME' | 'DEBTOR_PLACE' | 'DEBTOR_POSTAL_CODE' | 'DEBTOR_STREET_OR_ADDRESS_LINE_1' | 'DEBTOR_STREET_OR_ADDRESS_LINE_2' | 'DUE_DATE' | 'ENCODING' | 'FINAL_PAYEE_ADDRESS_TYPE' | 'FINAL_PAYEE_BUILDING_OR_ADDRESS_LINE_2' | 'FINAL_PAYEE_COUNTRY' | 'FINAL_PAYEE_NAME' | 'FINAL_PAYEE_PLACE' | 'FINAL_PAYEE_POSTAL_CODE' | 'FINAL_PAYEE_STREET_OR_ADDRESS_LINE_1' | 'IBAN' | 'PAYEE_ADDRESS_TYPE' | 'PAYEE_BUILDING_OR_ADDRESS_LINE_2' | 'PAYEE_COUNTRY' | 'PAYEE_NAME' | 'PAYEE_PLACE' | 'PAYEE_POSTAL_CODE' | 'PAYEE_STREET_OR_ADDRESS_LINE_1' | 'PAYMENT_REFERENCE' | 'PAYMENT_REFERENCE_TYPE' | 'UNKNOWN'

SwissQRCodeVersion

Swiss QR Code Version

'V1_0' | 'V2_0' | 'V2_1' | 'UNKNOWN'

VCardDocumentFormatFieldType

vCard Document Field Type

'ANNIVERSARY' | 'BIRTHDAY' | 'BUSY_TIME_URL' | 'CALENDAR_URI' | 'CALENDAR_URI_FOR_REQUESTS' | 'CATEGORIES' | 'CLIENT_PID_MAP' | 'CUSTOM' | 'DELIVERY_ADDRESS' | 'EMAIL' | 'FIRST_NAME' | 'GENDER' | 'GEO_LOCATION' | 'IMPP' | 'KIND' | 'LANGUAGES' | 'LOGO' | 'MEMBER' | 'NAME' | 'NICKNAME' | 'NOTE' | 'ORGANISATION' | 'PHOTO' | 'PRODUCT_ID' | 'PUBLIC_KEY' | 'RELATED' | 'REVISION' | 'ROLE' | 'SOUND' | 'SOURCE' | 'TELEPHONE_NUMBER' | 'TIME_ZONE' | 'TITLE' | 'UID' | 'URL' | 'VERSION' | 'XML' | 'UNKNOWN'

BarcodeDocumentFormat

Barcode document format

'AAMVA' | 'BOARDING_PASS' | 'DE_MEDICAL_PLAN' | 'MEDICAL_CERTIFICATE' | 'ID_CARD_PDF_417' | 'SEPA' | 'SWISS_QR' | 'VCARD' | 'GS1'

BarcodesExtensionFilter

A filter for extended EAN and UPC barcodes.

'NO_FILTER' | 'ONLY_WITH_EXTENSIONS' | 'ONLY_WITHOUT_EXTENSIONS'

EngineMode

Barcode scanner engine mode

'NEXT_GEN' | 'LEGACY'

Gs1HandlingMode

GS1 handling mode

'NONE' | 'PARSE' | 'VALIDATE' | 'DECODE'

MSIPlesseyChecksumAlgorithm

MSI plessey checksum algorithm

'NONE' | 'MOD_10' | 'MOD_11_IBM' | 'MOD_11_NCR' | 'MOD_1010' | 'MOD_1110_IBM' | 'MOD_1110_NCR'

CodeDensity

The expected density of QR codes in an image.

'LOW' | 'HIGH'

BarcodeDialogFormat

The barcode text format dialog.

'CODE' | 'TYPE_AND_CODE'

BlurEffect

The blur effect style. iOS only.

'EXTRA_LIGHT' | 'LIGHT' | 'DARK' | 'REGULAR' | 'PROMINENT' | 'SYSTEM_ULTRA_THIN_MATERIAL' | 'SYSTEM_THIN_MATERIAL' | 'SYSTEM_MATERIAL' | 'SYSTEM_THICK_MATERIAL' | 'SYSTEM_CHROME_MATERIAL' | 'SYSTEM_ULTRA_THIN_MATERIAL_LIGHT' | 'SYSTEM_THIN_MATERIAL_LIGHT' | 'SYSTEM_MATERIAL_LIGHT' | 'SYSTEM_THICK_MATERIAL_LIGHT' | 'SYSTEM_CHROME_MATERIAL_LIGHT' | 'SYSTEM_ULTRA_THIN_MATERIAL_DARK' | 'SYSTEM_THIN_MATERIAL_DARK' | 'SYSTEM_MATERIAL_DARK' | 'SYSTEM_THICK_MATERIAL_DARK' | 'SYSTEM_CHROME_MATERIAL_DARK'

BarcodeOverlayTextFormat

Barcode scanner engine mode

'NONE' | 'CODE' | 'CODE_AND_TYPE'

LicensePlateScanStrategy

Detector mode, classic (OCR based) or ML (machine learning based) approach.

'CLASSIC' | 'ML_BASED'

ValidationStatus

Barcode document format

'Invalid' | 'Valid'

GenericDocumentType

Supported document types

'DE_ID_CARD_FRONT' | 'DE_ID_CARD_BACK' | 'DE_PASSPORT' | 'DE_DRIVER_LICENSE_FRONT' | 'DE_DRIVER_LICENSE_BACK'

FieldDisplayState

Field display state in the RTU UI'HIDDEN' | 'VISIBLE_IF_NOT_EMPTY' | 'ALWAYS_VISIBLE'

CheckStatus

Check Status

'SUCCESS' | 'FAIL'

CheckStandard

Supported check standards.

'USA' | 'FRA' | 'KWT' | 'AUS' | 'IND' | 'ISR'

StorageImageFormat

Image format

'JPG' | 'PNG'

FileEncryptionMode

File encryption mode, 'AES128' or 'AES256'.

'AES128' | 'AES256'

LicenseStatus

The SDK license status

'Okay' | 'Trial' | 'Expired' | 'WrongOS' | 'Corrupted' | 'AppIDMismatch' | 'NotSet'

DocumentQuality

Enum that represents the analyzed text legibility on the images

'NO_DOCUMENT' | 'VERY_POOR' | 'POOR' | 'REASONABLE' | 'GOOD' | 'EXCELLENT'

MRZDocumentType

MRZ Document Type

'PASSPORT' | 'CREW_MEMBER_CERTIFICATE' | 'VISA' | 'ID_CARD' | 'SWISS_DRIVER_LICENSE' | 'UNDEFINED'

OCROutputFormat

'PLAIN_TEXT' | 'PDF_FILE' | 'RESULT_JSON' | 'FULL_OCR_RESULT'

OCREngineMode

'SCANBOT_OCR' | 'TESSERACT'

PDFPageSize

'A3' | 'A4' | 'A5' | 'B4' | 'B5' | 'COMM10' | 'CUSTOM' | 'EXECUTIVE' | 'LEGAL' | 'LETTER' | 'US4x6' | 'US4x8' | 'US5x7'

PDFPageOrientation

'PORTRAIT' | 'LANDSCAPE' | 'AUTO'

TIFFCompression

'NONE' | 'CCITTRLE' | 'CCITTFAX3' | 'CCITT_T4' | 'CCITTFAX4' | 'CCITT_T6' | 'LZW' | 'CCITTRLEW' | 'PACKBITS' | 'DEFLATE' | 'ADOBE_DEFLATE'

Want to scan longer than one minute?

Generate your free "no-strings-attached" Trial License and properly test the Scanbot SDK.

Get your free Trial License

What do you think of this documentation?