Captured ID

Defined in framework ScanditIdCapture

SDCCapturedId
@interface SDCCapturedId : NSObject

Added in version 6.6.0

A class that represents a result of a document scan. This class contains the captured information that is commonly present in all the documents, like the name or the date of birth of the holder.

The class can be cast to a concrete implementation using capturedResultType.

+ capturedIdFromJSONString:
+ (instancetype)capturedIdFromJSONString:(NSString *)JSONString

Added in version 6.12.0

Creates a captured id from the passed JSON string.

firstName
@property (nonatomic, nullable, readonly) NSString *firstName

Added in version 6.6.0

The first name of the document holder. Separated by spaces if more than one name is present. Characters can be all uppercase for document types which don’t capitalize names (for example names encoded in ICAO Machine Readable Zones).

lastName
@property (nonatomic, nullable, readonly) NSString *lastName

Added in version 6.6.0

The last name of the document holder. Separated by spaces if more than one name is present. Characters can be all uppercase for document types which don’t capitalize names (for example names encoded in ICAO Machine Readable Zones).

secondaryLastName
@property (nonatomic, nullable, readonly) NSString *secondaryLastName

Added in version 6.24.0

Optional secondary last name for document holders of French passports. This field holds the common name, known as “nom d’usage” when it is specified on the passport.

fullName
@property (nonatomic, nonnull, readonly) NSString *fullName

Added in version 6.6.0

The full name of the document holder. Characters can be all uppercase for document types which don’t capitalize names (for example names encoded in ICAO Machine Readable Zones).

sex
@property (nonatomic, nullable, readonly) NSString *sex

Added in version 6.6.0

The sex of the document holder.

dateOfBirth
@property (nonatomic, nullable, readonly) SDCDateResult *dateOfBirth

Added in version 6.6.0

The date of birth of the document holder. If the document doesn’t provide two first digits of the year then the date of birth is always set to be earlier than or equal to the scan date. For example if the year of scanning is 2021 and the document returns that the year of birth is 14 then the returned year is set to 2014. However if the document returns that the year of birth is 24 then the returned year is set to 1924.

age
@property (nonatomic, nullable, readonly) NSNumber *age

Added in version 6.16.0

The age of the document holder. Calculated as the difference in full years between the birth date and the current local date. If nil is returned it means that the full birth date is not available. The returned value depends on the device date. The same document may result in different values for devices with different dates (e.g. in different time zones, or with a date set manually by the user).

nationality
@property (nonatomic, nullable, readonly) NSString *nationality

Added in version 6.6.0

The nationality of the document holder represented by a three-letter code (Alpha-3 codes specified in ISO 3166-1).

address
@property (nonatomic, nullable, readonly) NSString *address

Added in version 6.6.0

The address of the document holder.

usRealIdStatus
@property (nonatomic, readonly) SDCUsRealIdStatus usRealIdStatus

Added in version 6.28.0

Indicates whether the document is REAL ID compliant.

capturedResultType
@property (nonatomic, readonly) SDCCapturedResultType capturedResultType

Added in version 6.6.0

The captured result type. Consult the documentation for more information about it.

Deprecated since version 6.11: Replaced by capturedResultTypes.

capturedResultTypes
@property (nonatomic, readonly) SDCCapturedResultType capturedResultTypes

Added in version 6.11.0

The captured result types. Guaranteed to contain at least one element. Consult the documentation for more information about it.

documentType
@property (nonatomic, readonly) SDCDocumentType documentType

Added in version 6.6.0

The document type. Consult the documentation for more information about it.

issuingCountryISO
@property (nonatomic, nullable, readonly) NSString *issuingCountryISO

Added in version 6.6.0

The ISO (Alpha-3 code) abbreviation of the issuing country of the document.

issuingCountry
@property (nonatomic, nullable, readonly) NSString *issuingCountry

Added in version 6.6.0

A human readable text identifying the country that issues the document.

documentNumber
@property (nonatomic, nullable, readonly) NSString *documentNumber

Added in version 6.6.0

The document number.

If SDCIdCaptureSettings.anonymizationMode is enabled for the field results, the returned value might be nil for certain documents.

documentAdditionalNumber
@property (nonatomic, nullable, readonly) NSString *documentAdditionalNumber

Added in version 6.19.0

If SDCIdCaptureSettings.anonymizationMode is enabled for the field results, the returned value might be nil for certain documents.

If SDCIdCaptureSettings.anonymizationMode is enabled for the field results, the returned value might be nil for certain documents.

dateOfExpiry
@property (nonatomic, nullable, readonly) SDCDateResult *dateOfExpiry

Added in version 6.6.0

The date of expiry of the document.

isExpired
@property (nonatomic, nullable, readonly) NSNumber *isExpired

Added in version 6.16.0

Whether this document is expired. Calculated by comparing the document’s expiration date with the current local date. When converted to boolean returns YES if the document is expired and NO if it’s not expired, or if it never expires. nil is returned if the value of this property could not be determined - for example if the date of expiry is not present, or if the date of expiry couldn’t be captured. Please note that the system time is used for computation of this field so users of the device are capable of changing the result of the field by changing the system time.

dateOfIssue
@property (nonatomic, nullable, readonly) SDCDateResult *dateOfIssue

Added in version 6.6.0

The date of issue of the document. Please note that some documents may specify the exact date of issue, while other the month and the year only.

aamvaBarcodeResult
@property (nonatomic, nullable, readonly) SDCAAMVABarcodeResult *aamvaBarcodeResult

Added in version 6.6.0

The additional information extracted from a barcode on a document that follows the American Association of Motor Vehicle Administrators (AAMVA) specification. This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeAAMVABarcodeResult, and is nil otherwise.

colombiaDlBarcodeResult
@property (nonatomic, nullable, readonly) SDCColombiaDlBarcodeResult *colombiaDlBarcodeResult

Added in version 6.13.0

The additional information extracted from a barcode on a Colombia Driver’s License (Licencia de Conducción). This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeColombiaDlBarcodeResult, and is nil otherwise.

colombiaIdBarcodeResult
@property (nonatomic, nullable, readonly) SDCColombiaIdBarcodeResult *colombiaIdBarcodeResult

Added in version 6.8.0

The additional information extracted from a barcode on a Colombia ID (Cédula de Ciudadanía). This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeColombiaIdBarcodeResult, and is nil otherwise.

argentinaIdBarcodeResult
@property (nonatomic, nullable, readonly) SDCArgentinaIdBarcodeResult *argentinaIdBarcodeResult

Added in version 6.8.0

The additional information extracted from a barcode on a Argentina ID (Documento Nacional de Identidad). This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeArgentinaIdBarcodeResult, and is nil otherwise.

southAfricaDLBarcodeResult
@property (nonatomic, nullable, readonly) SDCSouthAfricaDLBarcodeResult *southAfricaDLBarcodeResult

Added in version 6.8.0

The additional information extracted from a barcode on a South Africa Driver’s License. This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeSouthAfricaDLBarcodeResult, and is nil otherwise.

southAfricaIdBarcodeResult
@property (nonatomic, nullable, readonly) SDCSouthAfricaIdBarcodeResult *southAfricaIdBarcodeResult

Added in version 6.8.0

The additional information extracted from a barcode on a South Africa identity card (Smart ID Card). This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeSouthAfricaIdBarcodeResult, and is nil otherwise.

commonAccessCardBarcodeResult
@property (nonatomic, nullable, readonly) SDCCommonAccessCardBarcodeResult *commonAccessCardBarcodeResult

Added in version 6.18.0

mrzResult
@property (nonatomic, nullable, readonly) SDCMrzResult *mrzResult

Added in version 6.6.0

The additional information extracted from the Machine Readable Zone (MRZ) of a Machine Readable Travel Document (MRTD). This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeMrzResult, and is nil otherwise.

usUniformedServicesBarcodeResult
@property (nonatomic, nullable, readonly) SDCUsUniformedServicesBarcodeResult *usUniformedServicesBarcodeResult

Added in version 6.6.0

The additional information extracted from a barcode on a United States Uniformed Services Identification card. This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeUSUniformedServicesBarcodeResult, and is nil otherwise.

vizResult
@property (nonatomic, nullable, readonly) SDCVizResult *vizResult

Added in version 6.6.0

The additional information extracted from a documents or its part intended to be read by humans (for example Visual Inspection Zone (VIZ) of a Machine-Readable Travel Document (MRTD)). This property is guaranteed to be non-nil when capturedResultType is SDCCapturedResultTypeVizResult, and is nil otherwise.

chinaMainlandTravelPermitMrzResult
@property (nonatomic, nullable, readonly) SDCChinaMainlandTravelPermitMrzResult *chinaMainlandTravelPermitMrzResult

Added in version 6.14.0

The additional information extracted from a barcode on a China Mainland Travel Permit. This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeChinaMainlandTravelPermitMrzResult, and is nil otherwise.

chinaExitEntryPermitMrzResult
@property (nonatomic, nullable, readonly) SDCChinaExitEntryPermitMrzResult *chinaExitEntryPermitMrzResult

Added in version 6.14.0

The additional information extracted from the Machine Readable Zone (MRZ) present on an Exit-Entry Permit for Travelling to and from Hong Kong and Macau (往来港澳通行证) or an Exit-Entry Permit for Travelling to and from Taiwan (往来台灣通行证) issued by People’s Republic of China. This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeChinaMainlandTravelPermitMrzResult, and is nil otherwise.

chinaOneWayPermitBackMrzResult
@property (nonatomic, nullable, readonly) SDCChinaOneWayPermitBackMrzResult *chinaOneWayPermitBackMrzResult

Added in version 6.16.0

The additional information extracted from the Machine Readable Zone (MRZ) present on the back of a One-Way Permit to Hong Kong/Macau issued by People’s Republic of China. This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeChinaOneWayPermitBackMrzResult, and is nil otherwise.

chinaOneWayPermitFrontMrzResult
@property (nonatomic, nullable, readonly) SDCChinaOneWayPermitFrontMrzResult *chinaOneWayPermitFrontMrzResult

Added in version 6.16.0

The additional information extracted from the Machine Readable Zone (MRZ) present on the front of a One-Way Permit to Hong Kong/Macau issued by People’s Republic of China. This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeChinaOneWayPermitFrontMrzResult, and is nil otherwise.

apecBusinessTravelCardMrzResult
@property (nonatomic, nullable, readonly) SDCApecBusinessTravelCardMrzResult *apecBusinessTravelCardMrzResult

Added in version 6.16.0

The additional information extracted from the Machine Readable Zone (MRZ) present on the back of an APEC (Asia-Pacific Economic Cooperation) Business Travel Card. This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeApecBusinessTravelCardMrzResult, and is nil otherwise.

usVisaVizResult
@property (nonatomic, nullable, readonly) SDCUsVisaVizResult *usVisaVizResult

Added in version 6.18.0

The additional information extracted from the US Visa. This property is guaranteed to be non-nil when capturedResultTypes is SDCCapturedResultTypeUsVisaVizResult, and is nil otherwise.

- idImageOfType:
- (nullable UIImage *)idImageOfType:(SDCIdImageType)idImageType

Added in version 6.6.0

Gets a bitmap for an image type.

JSONString
@property (nonatomic, nonnull, readonly) NSString *JSONString

Added in version 6.6.0

Returns the JSON representation of the captured id.