Document Processing

Endpointhttps://api.dossiers.wiki

Submit documents for AI-powered validation and structured data extraction. Supports invoices, Sri Lankan identity documents, and company registration forms.

List processing instances

GET

https://api.dossiers.wiki

/document-processing

Retrieve a list of document processing instances with optional filters. Use includeFileUrls=true to get signed URLs (expires in 5 minutes).

List processing instances › query Parameters

processorId

string

Filter by processor ID

status

string · enum

Filter by processing status

Enum values:

pending

running

completed

failed

error

limit

number

Maximum number of results (default: 50)

offset

number

Number of results to skip (default: 0)

includeFileUrls

boolean

Include signed URLs for files (default: false). May impact performance for large lists.

List processing instances › Responses

200

List of processing instances

No data returned

GET/document-processing

curl --request GET \
  --url https://api.dossiers.wiki/document-processing

shell

Example Responses

{
  "instances": [
    {
      "instanceId": "65f3c1a2b4e5f60012345678",
      "processorId": "SRI_LANKA_ID",
      "status": "completed",
      "statusLabel": "Completed",
      "createdAt": "2026-03-05T11:35:06.000Z",
      "updatedAt": "2026-03-05T11:35:42.000Z",
      "completedAt": "2026-03-05T11:35:42.000Z"
    },
    {
      "instanceId": "65f3c1a2b4e5f60012345679",
      "processorId": "INVOICE",
      "status": "extracting",
      "statusLabel": "Extracting data",
      "createdAt": "2026-03-05T12:00:00.000Z",
      "updatedAt": "2026-03-05T12:00:15.000Z",
      "completedAt": null
    }
  ],
  "count": 2
}

json

application/json

Initiate document processing

POST

https://api.dossiers.wiki

/document-processing

Submit documents for processing against one of the available processor templates.

Available processors:

`processorId`	Accepted formats	Description
`INVOICE`	image/jpeg, image/png, application/pdf	Extracts and validates commercial invoices, tax invoices, proforma invoices, and credit notes
`SRI_LANKA_ID`	image/jpeg, image/png, application/pdf	KYC validation and data extraction for Sri Lankan passports, driver's licenses, and NICs (old & new). Also enriches with voter registration data when NIC is present.
`SRI_LANKA_FORM1_COMPANY_REGISTRATION`	application/pdf	Extracts company registration data from Sri Lankan Form 1 documents
`SRI_LANKA_FORM15_ANNUAL_RETURN`	application/pdf	Extracts annual return data from Sri Lankan Form 15 documents

The inputData field provides verification context to the AI — values are matched against extracted document fields. For example, passing name and dateOfBirth for an ID document tells the processor to flag a mismatch if the document doesn't match.

Synchronous steps (e.g., image cropping) run immediately. Validation and extraction are queued as background jobs by default. You will be notified via webhooks when processing completes.

Initiate document processing › Request Body

processorId

string · enum · required

ID of the document processor to use.

Enum values:

INVOICE

SRI_LANKA_ID

SRI_LANKA_FORM1_COMPANY_REGISTRATION

SRI_LANKA_FORM15_ANNUAL_RETURN

Example: INVOICE

object[] · required

Array of files to process (provide base64 data or URL for each file)

Example: [{"base64Data":"base64-encoded-file-data...","mimeType":"application/pdf","filename":"invoice.pdf"}]

inputData

object

Optional key-value context passed to the AI for cross-checking extracted document fields against known values.

INVOICE — supported keys:

expectedVendor — supplier name to verify against the document
expectedAmount — total amount to verify against the document

SRI_LANKA_ID — supported keys:

name — full name to match against the document
dateOfBirth — expected date of birth (YYYY-MM-DD)
idNumber — NIC or passport number to verify
address — residential address to compare (warning-level check)

Example: {"expectedVendor":"ACME Corp","expectedAmount":"1500.00"}

shouldCropImages

boolean

Whether to crop images before processing (default: true). When true, document images are cropped before validation and extraction.

Default: true

backgroundProcessing

boolean

Whether processing should happen in the background (default: true). If true, validation and extraction are performed asynchronously; if false, waits for all processing to complete before returning a response.

Default: true

Initiate document processing › Responses

Processing initiated successfully

No data returned

POST/document-processing

curl --request POST \
  --url https://api.dossiers.wiki/document-processing \
  --header 'Content-Type: application/json' \
  --data '
{
  "processorId": "INVOICE",
  "files": [
    {
      "base64Data": "<base64-encoded-file-data>",
      "mimeType": "application/pdf",
      "filename": "invoice.pdf"
    }
  ],
  "inputData": {
    "expectedVendor": "ACME Corp",
    "expectedAmount": "1500.00"
  }
}
'

shell

Example Request Body

{
  "processorId": "INVOICE",
  "files": [
    {
      "base64Data": "<base64-encoded-file-data>",
      "mimeType": "application/pdf",
      "filename": "invoice.pdf"
    }
  ],
  "inputData": {
    "expectedVendor": "ACME Corp",
    "expectedAmount": "1500.00"
  }
}

json

Extracts invoice fields (supplier, customer, line items, amounts) and cross-checks the expected vendor and total. Accepts PDF or image files.

application/json

Example Responses

{
  "instanceId": "65f3c1a2b4e5f60012345678",
  "processorId": "SRI_LANKA_ID",
  "status": "scanning",
  "statusLabel": "Scanning document",
  "createdAt": "2026-03-05T11:35:06.000Z",
  "updatedAt": "2026-03-05T11:35:06.000Z",
  "result": null,
  "files": [
    {
      "filename": "nic_front.jpg",
      "mimeType": "image/jpeg"
    }
  ]
}

json

application/json

List available document processors

GET

https://api.dossiers.wiki

/document-processing/processors

Returns all available document processor types with their schema fields, validation rules, extraction rules, recognised templates, and supported inputData keys.

List available document processors › Responses

200

List of available processors and their capabilities

object[]

Get a specific pipeline stage result

GET

https://api.dossiers.wiki

/document-processing/{id}/stages/{stageId}

Retrieve the full output of a single pipeline stage (e.g. crop_and_detect_faces, pre_validate_and_extract, post_validation). Returns the complete stage data including validation rules, extraction results, and schema.

Get a specific pipeline stage result › path Parameters

id

string · required

Processing instance ID

stageId

string · required

Stage ID (crop_and_detect_faces | pre_validate_and_extract | post_validation)

Get a specific pipeline stage result › Responses

Stage result

No data returned

GET/document-processing/{id}/stages/{stageId}

curl --request GET \
  --url https://api.dossiers.wiki/document-processing/:id/stages/:stageId

shell

Example Responses

{
  "stageId": "pre_validate_and_extract",
  "status": "success",
  "data": {
    "validation": {
      "status": "success",
      "passed": true,
      "reasoning": "All validation rules passed",
      "rulesPassed": [
        {
          "id": "is_valid_document",
          "confidence": 0.95
        },
        {
          "id": "name_matches",
          "confidence": 0.92
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "extraction": {
      "status": "success",
      "passed": true,
      "reasoning": "All fields extracted successfully",
      "rulesPassed": [
        {
          "id": "full_name",
          "confidence": 0.98
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "schema": {
      "fullName": {
        "value": "Kamal Perera",
        "originalText": "KAMAL PERERA",
        "originalTextConfidence": 0.98,
        "isOriginalTextHandwritten": false
      },
      "dateOfBirth": {
        "value": "1985-03-15",
        "originalText": "15.03.1985",
        "originalTextConfidence": 0.95,
        "isOriginalTextHandwritten": false
      }
    }
  }
}

json

application/json

Get processing instance

GET

https://api.dossiers.wiki

/document-processing/{id}

Retrieve the details and status of a document processing instance. File URLs are signed and expire in 5 minutes.

Get processing instance › path Parameters

id

string · required

Processing instance ID

Get processing instance › Responses

Processing instance retrieved successfully

No data returned

GET/document-processing/{id}

curl --request GET \
  --url https://api.dossiers.wiki/document-processing/:id

shell

Example Responses

{
  "instanceId": "65f3c1a2b4e5f60012345678",
  "processorId": "SRI_LANKA_ID",
  "status": "completed",
  "statusLabel": "Completed",
  "createdAt": "2026-03-05T11:35:06.000Z",
  "updatedAt": "2026-03-05T11:35:42.000Z",
  "completedAt": "2026-03-05T11:35:42.000Z",
  "result": {
    "documentTypeID": "sri_lanka_nic_new",
    "validation": {
      "status": "success",
      "passed": true,
      "reasoning": "All validation rules passed",
      "rulesPassed": [
        {
          "id": "is_valid_document",
          "confidence": 0.97
        },
        {
          "id": "name_matches",
          "confidence": 0.94
        },
        {
          "id": "dob_matches",
          "confidence": 0.99
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "extraction": {
      "status": "success",
      "passed": true,
      "reasoning": "All fields extracted successfully",
      "rulesPassed": [
        {
          "id": "full_name",
          "confidence": 0.98
        },
        {
          "id": "nic_number",
          "confidence": 0.99
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "schema": {
      "fullName": {
        "value": "Kamal Perera",
        "originalText": "KAMAL PERERA",
        "originalTextConfidence": 0.98,
        "isOriginalTextHandwritten": false
      },
      "nicNumber": {
        "value": "199512345678",
        "originalText": "199512345678",
        "originalTextConfidence": 0.99,
        "isOriginalTextHandwritten": false
      },
      "dateOfBirth": {
        "value": "1985-03-15",
        "originalText": "15.03.1985",
        "originalTextConfidence": 0.95,
        "isOriginalTextHandwritten": false
      },
      "sex": {
        "value": "Male"
      },
      "address": {
        "value": "123 Main Street, Colombo 03",
        "originalText": "123 Main Street, Colombo 03",
        "originalTextConfidence": 0.88,
        "isOriginalTextHandwritten": true
      }
    },
    "postProcessing": {
      "passed": true,
      "ruleResults": [
        {
          "id": "nic_dob_cross_check",
          "passed": true,
          "confidence": 1,
          "errorLevel": "error"
        },
        {
          "id": "voter_registration_lookup",
          "passed": true,
          "confidence": 0.95,
          "errorLevel": "warning",
          "message": "Voter registration record found"
        }
      ],
      "schemaModifications": [
        {
          "field": "voterRegistration",
          "value": {
            "registered": true,
            "district": "Colombo"
          },
          "source": "derived",
          "sourceDescription": "Derived from Sri Lanka Elections eServices lookup"
        }
      ]
    },
    "stages": [
      {
        "stageId": "crop_and_detect_faces",
        "status": "success"
      },
      {
        "stageId": "visual_integrity_check",
        "status": "success"
      },
      {
        "stageId": "pre_validate_and_extract",
        "status": "success"
      },
      {
        "stageId": "post_validation",
        "status": "success"
      },
      {
        "stageId": "voter_registry",
        "status": "success"
      }
    ]
  },
  "files": [
    {
      "filename": "nic_front.jpg",
      "mimeType": "image/jpeg",
      "url": "https://storage.example.com/signed-url..."
    }
  ]
}

json

application/json

Delete processing instance

DELETE

https://api.dossiers.wiki

/document-processing/{id}

Delete a document processing instance and its associated data

Delete processing instance › path Parameters

id

string · required

Processing instance ID

Delete processing instance › Responses

Processing instance deleted successfully

No data returned

Stream instance progress (SSE)

GET

https://api.dossiers.wiki

/document-processing/{id}/events

Subscribe to real-time Server-Sent Events for a processing instance. Events are emitted as each pipeline stage starts, succeeds, or fails. The connection stays open until the client disconnects.

Stream instance progress (SSE) › path Parameters

id

string · required

Processing instance ID

Stream instance progress (SSE) › Responses

200

SSE event stream

No data returned

AML Screening

Dossiers API

Document Processing

Endpointhttps://api.dossiers.wiki

Download schema

Submit documents for AI-powered validation and structured data extraction. Supports invoices, Sri Lankan identity documents, and company registration forms.

List processing instances

GET

https://api.dossiers.wiki

/document-processing

Retrieve a list of document processing instances with optional filters. Use includeFileUrls=true to get signed URLs (expires in 5 minutes).

List processing instances › query Parameters

processorId

string

Filter by processor ID

status

string · enum

Filter by processing status

Enum values:

pending

running

completed

failed

error

limit

number

Maximum number of results (default: 50)

offset

number

Number of results to skip (default: 0)

includeFileUrls

boolean

Include signed URLs for files (default: false). May impact performance for large lists.

List processing instances › Responses

200

List of processing instances

No data returned

GET/document-processing

curl --request GET \
  --url https://api.dossiers.wiki/document-processing

shell

Example Responses

{
  "instances": [
    {
      "instanceId": "65f3c1a2b4e5f60012345678",
      "processorId": "SRI_LANKA_ID",
      "status": "completed",
      "statusLabel": "Completed",
      "createdAt": "2026-03-05T11:35:06.000Z",
      "updatedAt": "2026-03-05T11:35:42.000Z",
      "completedAt": "2026-03-05T11:35:42.000Z"
    },
    {
      "instanceId": "65f3c1a2b4e5f60012345679",
      "processorId": "INVOICE",
      "status": "extracting",
      "statusLabel": "Extracting data",
      "createdAt": "2026-03-05T12:00:00.000Z",
      "updatedAt": "2026-03-05T12:00:15.000Z",
      "completedAt": null
    }
  ],
  "count": 2
}

json

application/json

Initiate document processing

POST

https://api.dossiers.wiki

/document-processing

Submit documents for processing against one of the available processor templates.

Available processors:

`processorId`	Accepted formats	Description
`INVOICE`	image/jpeg, image/png, application/pdf	Extracts and validates commercial invoices, tax invoices, proforma invoices, and credit notes
`SRI_LANKA_ID`	image/jpeg, image/png, application/pdf	KYC validation and data extraction for Sri Lankan passports, driver's licenses, and NICs (old & new). Also enriches with voter registration data when NIC is present.
`SRI_LANKA_FORM1_COMPANY_REGISTRATION`	application/pdf	Extracts company registration data from Sri Lankan Form 1 documents
`SRI_LANKA_FORM15_ANNUAL_RETURN`	application/pdf	Extracts annual return data from Sri Lankan Form 15 documents

Synchronous steps (e.g., image cropping) run immediately. Validation and extraction are queued as background jobs by default. You will be notified via webhooks when processing completes.

Initiate document processing › Request Body

processorId

string · enum · required

ID of the document processor to use.

Enum values:

INVOICE

SRI_LANKA_ID

SRI_LANKA_FORM1_COMPANY_REGISTRATION

SRI_LANKA_FORM15_ANNUAL_RETURN

Example: INVOICE

object[] · required

Array of files to process (provide base64 data or URL for each file)

Example: [{"base64Data":"base64-encoded-file-data...","mimeType":"application/pdf","filename":"invoice.pdf"}]

inputData

object

Optional key-value context passed to the AI for cross-checking extracted document fields against known values.

INVOICE — supported keys:

expectedVendor — supplier name to verify against the document
expectedAmount — total amount to verify against the document

SRI_LANKA_ID — supported keys:

name — full name to match against the document
dateOfBirth — expected date of birth (YYYY-MM-DD)
idNumber — NIC or passport number to verify
address — residential address to compare (warning-level check)

Example: {"expectedVendor":"ACME Corp","expectedAmount":"1500.00"}

shouldCropImages

boolean

Whether to crop images before processing (default: true). When true, document images are cropped before validation and extraction.

Default: true

backgroundProcessing

boolean

Default: true

Initiate document processing › Responses

Processing initiated successfully

No data returned

POST/document-processing

curl --request POST \
  --url https://api.dossiers.wiki/document-processing \
  --header 'Content-Type: application/json' \
  --data '
{
  "processorId": "INVOICE",
  "files": [
    {
      "base64Data": "<base64-encoded-file-data>",
      "mimeType": "application/pdf",
      "filename": "invoice.pdf"
    }
  ],
  "inputData": {
    "expectedVendor": "ACME Corp",
    "expectedAmount": "1500.00"
  }
}
'

shell

Example Request Body

{
  "processorId": "INVOICE",
  "files": [
    {
      "base64Data": "<base64-encoded-file-data>",
      "mimeType": "application/pdf",
      "filename": "invoice.pdf"
    }
  ],
  "inputData": {
    "expectedVendor": "ACME Corp",
    "expectedAmount": "1500.00"
  }
}

json

Extracts invoice fields (supplier, customer, line items, amounts) and cross-checks the expected vendor and total. Accepts PDF or image files.

application/json

Example Responses

{
  "instanceId": "65f3c1a2b4e5f60012345678",
  "processorId": "SRI_LANKA_ID",
  "status": "scanning",
  "statusLabel": "Scanning document",
  "createdAt": "2026-03-05T11:35:06.000Z",
  "updatedAt": "2026-03-05T11:35:06.000Z",
  "result": null,
  "files": [
    {
      "filename": "nic_front.jpg",
      "mimeType": "image/jpeg"
    }
  ]
}

json

application/json

List available document processors

GET

https://api.dossiers.wiki

/document-processing/processors

Returns all available document processor types with their schema fields, validation rules, extraction rules, recognised templates, and supported inputData keys.

List available document processors › Responses

200

List of available processors and their capabilities

object[]

Get a specific pipeline stage result

GET

https://api.dossiers.wiki

/document-processing/{id}/stages/{stageId}

Get a specific pipeline stage result › path Parameters

id

string · required

Processing instance ID

stageId

string · required

Stage ID (crop_and_detect_faces | pre_validate_and_extract | post_validation)

Get a specific pipeline stage result › Responses

Stage result

No data returned

GET/document-processing/{id}/stages/{stageId}

curl --request GET \
  --url https://api.dossiers.wiki/document-processing/:id/stages/:stageId

shell

Example Responses

{
  "stageId": "pre_validate_and_extract",
  "status": "success",
  "data": {
    "validation": {
      "status": "success",
      "passed": true,
      "reasoning": "All validation rules passed",
      "rulesPassed": [
        {
          "id": "is_valid_document",
          "confidence": 0.95
        },
        {
          "id": "name_matches",
          "confidence": 0.92
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "extraction": {
      "status": "success",
      "passed": true,
      "reasoning": "All fields extracted successfully",
      "rulesPassed": [
        {
          "id": "full_name",
          "confidence": 0.98
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "schema": {
      "fullName": {
        "value": "Kamal Perera",
        "originalText": "KAMAL PERERA",
        "originalTextConfidence": 0.98,
        "isOriginalTextHandwritten": false
      },
      "dateOfBirth": {
        "value": "1985-03-15",
        "originalText": "15.03.1985",
        "originalTextConfidence": 0.95,
        "isOriginalTextHandwritten": false
      }
    }
  }
}

json

application/json

Get processing instance

GET

https://api.dossiers.wiki

/document-processing/{id}

Retrieve the details and status of a document processing instance. File URLs are signed and expire in 5 minutes.

Get processing instance › path Parameters

id

string · required

Processing instance ID

Get processing instance › Responses

Processing instance retrieved successfully

No data returned

GET/document-processing/{id}

curl --request GET \
  --url https://api.dossiers.wiki/document-processing/:id

shell

Example Responses

{
  "instanceId": "65f3c1a2b4e5f60012345678",
  "processorId": "SRI_LANKA_ID",
  "status": "completed",
  "statusLabel": "Completed",
  "createdAt": "2026-03-05T11:35:06.000Z",
  "updatedAt": "2026-03-05T11:35:42.000Z",
  "completedAt": "2026-03-05T11:35:42.000Z",
  "result": {
    "documentTypeID": "sri_lanka_nic_new",
    "validation": {
      "status": "success",
      "passed": true,
      "reasoning": "All validation rules passed",
      "rulesPassed": [
        {
          "id": "is_valid_document",
          "confidence": 0.97
        },
        {
          "id": "name_matches",
          "confidence": 0.94
        },
        {
          "id": "dob_matches",
          "confidence": 0.99
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "extraction": {
      "status": "success",
      "passed": true,
      "reasoning": "All fields extracted successfully",
      "rulesPassed": [
        {
          "id": "full_name",
          "confidence": 0.98
        },
        {
          "id": "nic_number",
          "confidence": 0.99
        }
      ],
      "rulesFailed": [],
      "rulesIgnored": [],
      "userErrorMessages": []
    },
    "schema": {
      "fullName": {
        "value": "Kamal Perera",
        "originalText": "KAMAL PERERA",
        "originalTextConfidence": 0.98,
        "isOriginalTextHandwritten": false
      },
      "nicNumber": {
        "value": "199512345678",
        "originalText": "199512345678",
        "originalTextConfidence": 0.99,
        "isOriginalTextHandwritten": false
      },
      "dateOfBirth": {
        "value": "1985-03-15",
        "originalText": "15.03.1985",
        "originalTextConfidence": 0.95,
        "isOriginalTextHandwritten": false
      },
      "sex": {
        "value": "Male"
      },
      "address": {
        "value": "123 Main Street, Colombo 03",
        "originalText": "123 Main Street, Colombo 03",
        "originalTextConfidence": 0.88,
        "isOriginalTextHandwritten": true
      }
    },
    "postProcessing": {
      "passed": true,
      "ruleResults": [
        {
          "id": "nic_dob_cross_check",
          "passed": true,
          "confidence": 1,
          "errorLevel": "error"
        },
        {
          "id": "voter_registration_lookup",
          "passed": true,
          "confidence": 0.95,
          "errorLevel": "warning",
          "message": "Voter registration record found"
        }
      ],
      "schemaModifications": [
        {
          "field": "voterRegistration",
          "value": {
            "registered": true,
            "district": "Colombo"
          },
          "source": "derived",
          "sourceDescription": "Derived from Sri Lanka Elections eServices lookup"
        }
      ]
    },
    "stages": [
      {
        "stageId": "crop_and_detect_faces",
        "status": "success"
      },
      {
        "stageId": "visual_integrity_check",
        "status": "success"
      },
      {
        "stageId": "pre_validate_and_extract",
        "status": "success"
      },
      {
        "stageId": "post_validation",
        "status": "success"
      },
      {
        "stageId": "voter_registry",
        "status": "success"
      }
    ]
  },
  "files": [
    {
      "filename": "nic_front.jpg",
      "mimeType": "image/jpeg",
      "url": "https://storage.example.com/signed-url..."
    }
  ]
}

json

application/json

Delete processing instance

DELETE

https://api.dossiers.wiki

/document-processing/{id}

Delete a document processing instance and its associated data

Delete processing instance › path Parameters

id

string · required

Processing instance ID

Delete processing instance › Responses

Processing instance deleted successfully

No data returned

Stream instance progress (SSE)

GET

https://api.dossiers.wiki

/document-processing/{id}/events

Subscribe to real-time Server-Sent Events for a processing instance. Events are emitted as each pipeline stage starts, succeeds, or fails. The connection stays open until the client disconnects.

Stream instance progress (SSE) › path Parameters

id

string · required

Processing instance ID

Stream instance progress (SSE) › Responses

200

SSE event stream

No data returned

AML Screening