---
title: "Initiate a new Document Trust Analysis"
method: POST
path: "/document_analyses"
tags: ["Document Trust Analysis"]
---

# Initiate a new Document Trust Analysis

`POST /document_analyses`

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

Related guide: [Document Trust Analysis](https://developers.youtrust.com/docs/document-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 (not supported for `tax_notice`).
- `extraction: false` (fraud-only): no data extraction. `type` must be omitted and `fraud_level` must be `advanced`.

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"`).

**🔓 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`

## Request body

- InitiateDocumentAnalysisFromApplicant
  - `applicant_id` string, uuid, required — The Applicant ID linked to the Workflow Session.
  - `type` 'social_security' | 'company_certificate' | 'business_registration_certificate' | 'driver_licence' | 'rne_certificate' | 'temporary_vehicle_registration_document' | 'vehicle_registration_document' | 'auto_insurance_claims_history' | 'tax_notice' | 'payslip' | 'invoice' | 'proof_of_address' | 'id_document', required — Type of document you want to analyze. Will be used to match the detected document type.
  - `analysis_type` AnalysisType — Describes what the Document Analysis performed. - `extraction: true`: data was extracted from the document (a document `type` is present). - `extraction: false`: fraud-only analysis (no data extraction, no `type`).
    - `extraction` boolean — Whether data was extracted from the document.
    - `fraud_level` string — Level of fraud detection that was run. `null` when fraud detection was not requested.
  - `country_code` 'FR' | 'IT' | 'DE' — The country code of the document. Required when `type` is `vehicle_registration_document` (accepted: `FR`, `IT`), `tax_notice` (accepted: `FR`, `DE`), `payslip` (accepted: `FR`, `IT`), `invoice` (accepted: `FR`, `IT`, `DE`), `proof_of_address` (accepted: `IT`, `DE`) or `id_document` (accepted: `DE`).
  - `checks` InitiateDocumentAnalysisFromApplicantChecks, nullable — Checks to perform on the document. Only accepted when `type` is `tax_notice`.
    - `income_year_check` InitiateDocumentAnalysisFromApplicantChecksIncomeYearCheck — Expected income year to check against the document.
      - `income_year` integer, required — The expected income year to check against the tax notice document.

## Response `201`

OK

- PostDocumentAnalyses201Response — unresolved $ref

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `415` — UnsupportedMediaType
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.dev/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)