Retrieve Document Analysis results via Webhooks

Webhooks provide an efficient way to get notified when an Document Trust Analysis has been completed, and to retrieve the related results. For more details on setting up and managing Webhooks, please refer to this dedicated section.

To receive those notifications, subscribe to the following event:

Event	Description
`document_analysis.done`	Triggered when a document analysis is completed

Example Webhook payload for a Document Trust Analysis with a status : done

{
    "id": "023bb153-7901-49c2-b670-62990a1adezb1",
    "workspace_id": "7e7895fe-f647-47d0-9a75-da811834d092",
    "workflow_session_id": null,
    "previous_attempt_id": null,
    "applicant_id": null,
    "created_at": "2026-06-22T11:54:18+00:00",
    "updated_at": "2026-06-22T11:54:55+00:00",
    "status": "failed",
    "status_codes": [
        "DA_1002",
        "DA_3001"
    ],
    "type": "company_certificate",
    "country_code": null,
    "data_anonymized": false,
    "extracted_from_document": {
        "verification_number": "2021A12614",
        "company_name": "Greffe du Tribunal de Commerce de Paris",
        "company_number": "904893488",
        "registered_address": "123 rue Dupont",
        "issuance_date": "2023-09-07",
        "legal_representatives": [
            {
                "type": "natural_person",
                "first_name": "John Doe",
                "last_name": "John",
                "full_name": "Doe",
                "function": "Exploitation personnelle",
                "company_name": null,
                "company_number": null
            }
        ],
        "document_type": "KBIS"
    },
    "checks": null,
    "analysis_type": {
        "extraction": true,
        "fraud_level": "advanced"
    },
    "fraud_risk_analysis": {
        "risk_level": "medium",
        "indicators": [
            {
                "indicator": "not_original_document",
                "type": "RISK",
                "category": "modification",
                "title": "Not the original image",
                "description": "This image appears to be a reproduction rather than the original file. It shows signs of post-processing, such as cropping, re-saving, re-printing, or metadata changes. These changes reduce confidence in the image’s authenticity and could conceal signs of editing."
            },
            {
                "indicator": "has_known_producer",
                "type": "INFO",
                "category": "producer",
                "title": "Produced in Skia",
                "description": "This document was produced using Skia."
            },
        ]
    }
}

{
    "id": "@uuid@",
    "workspace_id": "@uuid@",
    "status": "done",
    "type": "social_security",
    "data_anonymized": false,
    "created_at": "@datetime@",
    "updated_at": "@datetime@",
    "extracted_from_document": {
        "first_name": "John",
        "last_name": "Doe",
        "social_security_number": "1234567890123",
	      "full_name": "John Doe", 
				"document_type" : "Carte Vitale"

    }, 
    "checks": null,
    "analysis_type": {
        "extraction": true,
        "fraud_level": null
    },
    "fraud_risk_analysis": null
}

{
    "id": "@uuid@",
    "workspace_id": "@uuid@",
    "status": "done",
    "type": "social_security",
    "data_anonymized": false,
    "created_at": "@datetime@",
    "updated_at": "@datetime@",
    "extracted_from_document": {
        "first_name": "John",
        "last_name": "Doe",
        "social_security_number": "1234567890123",
      	"full_name": "John Doe",
				"document_type" : "Carte Vitale"
    }, 
     "checks" : {
       "full_name" :{
         "extracted": "John Doe",   	
         "expected" : "John Doe",
         "match_level": "exact"
       } 
     },
    "analysis_type": {
        "extraction": true,
        "fraud_level": null
    },
    "fraud_risk_analysis": null
}

For more information on the statuses, refer to this section.

Retrieve detailed Document Trust Analysis results

You can also obtain detailed Document Trust Analysis results by calling a dedicated endpoint, with the id returned when requesting a Document Trust Analysis :

GET /document_analyses/{id}

{
    "id": "023bb153-7901-49c2-b670-62990a1adezb1",
    "workspace_id": "7e7895fe-f647-47d0-9a75-da811834d092",
    "workflow_session_id": null,
    "previous_attempt_id": null,
    "applicant_id": null,
    "created_at": "2026-06-22T11:54:18+00:00",
    "updated_at": "2026-06-22T11:54:55+00:00",
    "status": "failed",
    "status_codes": [
        "DA_1002",
        "DA_3001"
    ],
    "type": "company_certificate",
    "country_code": null,
    "data_anonymized": false,
    "extracted_from_document": {
        "verification_number": "2021A12614",
        "company_name": "Greffe du Tribunal de Commerce de Paris",
        "company_number": "904893488",
        "registered_address": "123 rue Dupont",
        "issuance_date": "2023-09-07",
        "legal_representatives": [
            {
                "type": "natural_person",
                "first_name": "John Doe",
                "last_name": "John",
                "full_name": "Doe",
                "function": "Exploitation personnelle",
                "company_name": null,
                "company_number": null
            }
        ],
        "document_type": "KBIS"
    },
    "checks": null,
    "analysis_type": {
        "extraction": true,
        "fraud_level": "advanced"
    },
    "fraud_risk_analysis": {
        "risk_level": "medium",
        "indicators": [
            {
                "indicator": "not_original_document",
                "type": "RISK",
                "category": "modification",
                "title": "Not the original image",
                "description": "This image appears to be a reproduction rather than the original file. It shows signs of post-processing, such as cropping, re-saving, re-printing, or metadata changes. These changes reduce confidence in the image’s authenticity and could conceal signs of editing."
            },
            {
                "indicator": "has_known_producer",
                "type": "INFO",
                "category": "producer",
                "title": "Produced in Skia",
                "description": "This document was produced using Skia."
            },
        ]
    }
}

{
    "id": "@uuid@",
    "workspace_id": "@uuid@",
    "status": "done",
    "type": "social_security",
    "data_anonymized": false,
    "created_at": "@datetime@",
    "updated_at": "@datetime@",
    "extracted_from_document": {
        "first_name": "John",
        "last_name": "Doe",
        "social_security_number": "1234567890123",
        "full_name": "John Doe"
    }
}

{
    "id": "@uuid@",
    "workspace_id": "@uuid@",
    "status": "done",
    "type": "social_security",
    "data_anonymized": false,
    "created_at": "@datetime@",
    "updated_at": "@datetime@",
    "extracted_from_document": {
        "first_name": "John",
        "last_name": "Doe",
        "social_security_number": "1234567890123",
        "full_name": "John Doe"
    }, 
     "checks" : {
       "full_name" :{
         "extracted": "John Doe",   	
         "expected" : "John Doe",
         "match_level": "exact"
       } 
    }
}

Similar to the webhook, you will receive the Document Trust Analysis status if the status was failed. For more information on the statuses, refer to this section .

After 7 days, Document Trust Analysis results are anonymized, meaning all personal or sensitive data associated with the Document Analysis request is permanently deleted.

If you attempt to retrieve any verification details beyond this retention period, fields containing sensitive data will return null, and the data_anonymized parameter will be set to true:

{
    "id": "@uuid@",
    "workspace_id": "@uuid@",
    "status": "done",
    "type": "social_security",
    "data_anonymized": true,
    "created_at": "@datetime@",
    "updated_at": "@datetime@",
    "extracted_from_document": {
        "first_name": null,
        "last_name": null,
        "social_security_number": null,
        "full_name": null
    },
	  "checks" : null,
    "analysis_type": {
        "extraction": true,
        "fraud_level": null
    },
    "fraud_risk_analysis": null
}

{
    "id": "@uuid@",
    "workspace_id": "@uuid@",
    "status": "done",
    "type": "social_security",
    "data_anonymized": false,
    "created_at": "@datetime@",
    "updated_at": "@datetime@",
    "extracted_from_document": {
        "first_name": null,
        "last_name": null,
        "social_security_number": null,
        "full_name": null
    }, 
     "checks" : {
       "full_name" :{
         "extracted": null,   	
         "expected" : null,
         "match_level": "exact"
       } 
     },
    "analysis_type": { 
        "extraction": true,
        "fraud_level": null
    },
    "fraud_risk_analysis": null
}

List all Document Trust Analysis requests

To retrieve a list of all Document Trust Analysis requests, you can call the following endpoint. You can filter by status or paginate the results based on your needs:

GET /document_analyses

{
    "meta": {
        "next_cursor": "string"
    },
    "data": [
        {
            "id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
            "workspace_id": "090b4f7e-25e8-423d-9387-741f6188ba7a",
            "created_at": "2025-03-24T13:32:26+00:00",
            "updated_at": "2025-03-24T13:32:46+00:00",
            "status": "pending",
            "data_anonymized": false
        }
    ]
}