Documentation Index Fetch the complete documentation index at: https://docs.deepxl.ai/llms.txt
Use this file to discover all available pages before exploring further.
1. Get Your API Key
Sign in to the DeepXL Console and create an API key from the API Keys section.
2. Detect Document Fraud
Upload a file to the Document Model to check for manipulation:
curl -X POST https://api.deepxl.ai/v1/detection \
-H "x-api-key: YOUR_API_KEY" \
-F "model=document" \
-F "file=@bank_statement.pdf" \
-F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-001","companyName":"DeepXL","companyId":"COMP-001"}'
You will receive a response with a fraud likelihood score (0–100%), severity level (low, medium, high), quality classification (verified, unverified, rejected), and detailed reasoning:
{
"result" : {
"detectionId" : 42 ,
"mediaType" : "document" ,
"fileType" : "pdf" ,
"fileName" : "bank_statement.pdf" ,
"fileSize" : 245678 ,
"timestamp" : 1725795600 ,
"timestampISO" : "2024-09-08T10:00:00.000000" ,
"model" : "document" ,
"modelVersion" : "1.1.0" ,
"likelihood" : 15.5 ,
"fraudSeverity" : "low" ,
"classification" : "verified" ,
"reasoning" : [
"Document structure appears authentic" ,
"No manipulation detected"
],
"modelResults" : {
"technicalChecks" : [
{ "type" : "DOCUMENT_CLASSIFIER" , "status" : "PASS" , "details" : "Classified as bank statement" , "likelihood" : 0.0 },
{ "type" : "SEMANTIC_QUALITY" , "status" : "PASS" , "details" : "Image quality is acceptable" , "likelihood" : 0.0 },
{ "type" : "SEMANTIC_FRAUD" , "status" : "PASS" , "details" : "No tampering indicators found" , "likelihood" : 0.0 }
]
},
"files" : [
{
"category" : "original_file" ,
"fileName" : "fd_42_bank_statement.pdf" ,
"url" : "https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf"
}
]
}
}
Use the Parsing Model to extract structured data from an ID:
curl -X POST https://api.deepxl.ai/v1/parse \
-H "x-api-key: YOUR_API_KEY" \
-F "model=light" \
-F "file=@drivers_license.jpg"
{
"result" : {
"parseId" : 117 ,
"mediaType" : "image" ,
"fileType" : "jpeg" ,
"fileName" : "drivers_license.jpg" ,
"fileSize" : 231433 ,
"timestamp" : 1725795600 ,
"timestampISO" : "2024-09-08T10:00:00.000000" ,
"model" : "light" ,
"modelVersion" : "1.2.0" ,
"documentType" : "idDocument" ,
"parsedData" : {
"firstName" : "JOHN" ,
"lastName" : "DOE" ,
"dateOfBirth" : "1990-05-15" ,
"licenseNumber" : "D1234567" ,
"expirationDate" : "2028-05-15" ,
"address" : "123 MAIN ST ANYTOWN, CA 90210"
},
"files" : [
{
"category" : "original_file" ,
"fileName" : "drivers_license.jpg" ,
"url" : "https://api.deepxl.ai/v1/files/parse_117_drivers_license.jpg"
}
]
}
}
4. Verify Identity
Use the ID-Selfie Model to match a person’s ID against their selfie:
curl -X POST https://api.deepxl.ai/v1/verification \
-H "x-api-key: YOUR_API_KEY" \
-F "idFile=@passport.jpg" \
-F "selfieFile=@selfie.jpg"
{
"result" : {
"verificationId" : 457 ,
"idFileName" : "passport.jpg" ,
"selfieFileName" : "selfie.jpg" ,
"timestamp" : 1725795600 ,
"timestampISO" : "2024-09-08T10:00:00.000000" ,
"model" : "verification" ,
"modelVersion" : "1.0.0" ,
"verified" : true ,
"modelResults" : {
"technicalChecks" : [
{
"checkType" : "face_detection" ,
"likelihood" : 99.85 ,
"faceCount" : { "id" : 1 , "selfie" : 1 },
"idFaces" : [
{ "faceId" : "face_1" , "detectionConfidence" : 0.9992 }
],
"selfieFaces" : [
{ "faceId" : "face_1" , "detectionConfidence" : 0.9985 }
]
}
]
},
"files" : [
{
"category" : "id" ,
"fileName" : "passport.jpg" ,
"url" : "https://api.deepxl.ai/v1/files/v_id_457_passport.jpg"
},
{
"category" : "face" ,
"fileName" : "selfie.jpg" ,
"url" : "https://api.deepxl.ai/v1/files/v_face_457_selfie.jpg"
}
]
}
}
What’s Next?
Authentication Learn about API key authentication.
Fraud Detection Guide Document and Object models, likelihood scores, and filtering.