Initiate a new Document Trust Analysis

Initiate a new Document Trust Analysis to extract data from a given document type.

Related guide: Document Trust Analysis

ℹ️ This endpoint accepts two request body formats — pick the one that matches your use case:

  • 📁 multipart/form-data — upload a binary file containing the document to analyse.
  • 📝 application/json — reference an existing Workflow Session Applicant by ID.

🔎 Analysis type (analysis_type)

  • extraction: true (default): data is extracted from the document. A document type is required. Optionally set fraud_level (standard or advanced) to also run fraud detection.
  • extraction: false (fraud-only): no data extraction. Only available with multipart/form-data (direct file upload): type is optional and fraud_level must be standard or advanced. When type is set, the classification checks that the document is of this type (DA_1003 or DA_1004 otherwise). When type is omitted, the classification is only reported in document_classification. Not supported with the application/json (Applicant) variant, where a document type is always required.

On multipart/form-data, analysis_type is sent as form fields (analysis_type[extraction], analysis_type[fraud_level]) and extraction is a string ("true"/"false").

🧾 Tax notice (tax_notice) in France, per fraud_level

The 2D-Doc printed on the French tax notice is read only with standard.

fraud_levelFilesExtraction2d_docDA_1304Checks compared withFraud detection
none or omittedPDF, JPG, PNGYesnullNeverValues read in the textNone
standardPDF onlyYesFilled when an income tax notice 2D-Doc (ANTS type 04, or 28 since 2025) is found and its signature and certificate are valid. Otherwise nullWhen the file was read and holds no 2D-Doc: the analysis is failed. A 2D-Doc that cannot be read gives inconclusive with DA_3004, or failed with DA_3001 when the fraud risk is blockingThe valid 2D-Doc, otherwise the values read in the textDocument Trust (fraud_risk_analysis, barcode.* indicators)
advancedPDF, JPG, PNGYesnullNeverValues read in the textResistant (fraud_risk_analysis)
standard, extraction: falsePDF onlyNo (classification only)None: extracted_from_document is []NeverNoneDocument Trust. The 2D-Doc signature and certificate are checked only when a 2D-Doc is found, so a tax notice without a 2D-Doc can end done
advanced, extraction: falsePDF, JPG, PNGNo (classification only)None: extracted_from_document is []NeverNoneResistant

🔓 Endpoint access

  • Environments: production, sandbox
  • API key scopes: organization, workspace
  • Plans: pro, scale
  • Add-ons (for production access):
    • For extraction only Document Analysis
    • For Fraud Detection with fraud_level set to standard and Extraction Document Trust Standard
    • For Fraud Detection with fraud_level set to advanced and Extraction Document Trust Advanced
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
Loading…
Responses

Language
Credentials
Bearer
URL
Loading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json