Skip to main content
POST
/
v1
/
parse
Parse Document
curl --request POST \
  --url https://api.deepxl.ai/v1/parse \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'model=<string>' \
  --form 'file=<string>' \
  --form 'tags={}'
{
  "result": {
    "parseId": 117,
    "mediaType": "image",
    "fileType": "jpeg",
    "fileName": "drivers_license.jpg",
    "fileSize": 231433,
    "model": "light",
    "documentType": "usa_driver_license",
    "parsedData": {
      "firstName": "JOHN",
      "lastName": "DOE",
      "dateOfBirth": "1990-05-15",
      "licenseNumber": "D1234567",
      "expirationDate": "2028-05-15",
      "address": "123 MAIN ST ANYTOWN, CA 90210"
    },
    "timestamp": 1725795600,
    "timestampISO": "2024-09-08T10:00:00.000000",
    "tags": [
      {
        "name": "customerId",
        "value": "9999"
      },
      {
        "name": "customerName",
        "value": "Acme Corp"
      },
      {
        "name": "documentId",
        "value": "DOC-2024-001"
      },
      {
        "name": "companyName",
        "value": "DeepXL"
      },
      {
        "name": "companyId",
        "value": "COMP-001"
      }
    ],
    "files": [
      {
        "category": "original_file",
        "fileName": "drivers_license.jpg",
        "fileSize": 231433,
        "contentType": "image/jpeg",
        "timestamp": 1725795600,
        "timestampISO": "2024-09-08T10:00:00.000000",
        "url": "https://api.deepxl.ai/v1/files/parse_117_drivers_license.jpg"
      }
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

API key created in the dashboard

Body

multipart/form-data
​
model
string
required

AI model to use for parsing. 'light': Parsing light model (Driver License, State ID, Residency Permit, Social Security Card, Military ID). 'performance': Parsing performance model (Bank statements, US pay stubs).

​
file
string
required
​
tags
string | null
default:{}

Optional JSON object with key-value pairs for organizing and querying results. Example: {"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-2024-001","companyName":"DeepXL","companyId":"COMP-001"}. Common keys: customerId, customerName, documentId, companyName, companyId.

Response

Document processed successfully with extracted parsed data.

​
result
APIParse · object
required

The document parse result