RESTful Web Service to parse an image of the Back of a Driver's License
POST https://app1.idware.net/DriverLicenseParserRest.svc/ParseImage HTTP/1.1
Host: app1.idware.net
Content-Type: text/json
Cache-Control: no-cache
{
"authKey": "authKey",
"data": "base-64 encoded driver license back side image"
}
Response
"ParseImageResult": {
"Confidence": 0,//Confidence in the validity of a document [0-100]
"DriverLicense": null,//Document data
"ErrorMessage": "",//Error message if Success == false
"Reference": null,//Unique ID for driving license identification
"Success": false,//Request status
"ValidationCode": //Validation status (only for success requests)
{
"Errors": [], //Error codes
"IsValid": false
}
}
Successful request
{
"ParseImageResult": {
"Confidence": 60,
"DriverLicense": {
"Address1": "4802 SHEBOYGAN AVE",
"Address2": "",
"Birthdate": "1994-05-08",
"CardRevisionDate": "2012-03-16",
"City": "MADISON",
"ClassificationCode": "",
"ComplianceType": " ",
"Country": "United States of America",
"CountryCode": "USA",
"DocumentType": "ID",
"EndorsementCodeDescription": "",
"EndorsementsCode": "",
"ExpirationDate": "2020-05-08",
"EyeColor": "Blue",
"FirstName": "CHLOE",
"FullName": "CHLOE A ZZZSAMPLE",
"Gender": "Female",
"HAZMATExpDate": null,
"HairColor": "",
"Height": "070 IN",
"IIN": "636031",
"IssueDate": "2012-04-18",
"IssuedBy": "WI",
"JurisdictionCode": "WI",
"LastName": "ZZZSAMPLE",
"LicenseNumber": "Z5141019466802",
"LimitedDurationDocument": null,
"MiddleName": "A",
"NamePrefix": "",
"NameSuffix": "",
"OrganDonor": null,
"PostalBox": "",
"PostalCode": "53705-2927",
"Race": "",
"RestrictionCode": "",
"RestrictionCodeDescription": "",
"VehicleClassCode": "",
"VehicleClassCodeDescription": "",
"Veteran": null,
"WeightKG": "",
"WeightLBS": ""
},
"ErrorMessage": "OK",
"Reference": "B9A7A0CE9CB078D9DB39F72AD18F35424B58EDA1",
"Success": true,
"ValidationCode": {
"Errors": [
"10202"
],
"IsValid": false
}
}
}
Error
{
"ParseImageResult": {
"Confidence": 0,
"DriverLicense": null,
"ErrorMessage": "Invalid image format",
"Reference": null,
"Success": false,
"ValidationCode": null
}
}