Statuses
Complete reference of statuses used in the Aprovall API for documents and dossiers.
Document Statuses
Each document requested in a dossier has a status indicating its progress in the verification workflow.
| Status | Description | Actor |
|---|---|---|
| MISSING | Not yet submitted by the third party | — |
| IN_PROGRESS | Collection/processing and verification in progress | Aprovall |
| ACTION_REQUIRED | Awaiting manual validation or rejection by client | Client |
| VALID | Present and valid (automatically or manually) | Aprovall / Client |
| NOT_VALID | Rejected by Aprovall verification or manual rejection | Aprovall / Client |
| BELOW_EXPECTATION | Rejected by client without propagation to third party | Client |
Verification Workflow
A document's status evolves according to a precise workflow involving multiple actors:
The client creates a dossier with required documents. Status: MISSING
The third party uploads the document. Status: IN_PROGRESS
Automatic verification by AI and/or external sources.
Depending on the result: VALID (auto-validation), NOT_VALID (auto-rejection), or ACTION_REQUIRED (manual validation required).
Some accounts have an additional client verification step enabled. In this case, even after Aprovall validation, the document may move to ACTION_REQUIRED for final manual validation.
Dossier Statuses
The overall dossier status is automatically calculated from the statuses of all its documents:
| Status | Condition |
|---|---|
| VALID | All documents are in VALID status |
| IN_PROGRESS | At least one document is MISSING, IN_PROGRESS or ACTION_REQUIRED |
| NOT_VALID | At least one document is NOT_VALID or BELOW_EXPECTATION |
Available Document Actions
Depending on the document status, different actions are available via the API:
| Current Status | Available Actions |
|---|---|
| ACTION_REQUIRED | approve → becomes VALIDreject → becomes NOT_VALID or BELOW_EXPECTATION |
| VALID | Download the document (PDF) |
| NOT_VALID | New automatic request to third party |
NOT_VALID vs BELOW_EXPECTATION Difference
These two statuses indicate rejection but with different behaviors:
| Status | Propagation | Use Case |
|---|---|---|
| NOT_VALID | Third party is notified and must provide a new document | Non-compliant, illegible, expired document |
| BELOW_EXPECTATION | No notification to third party | Acceptable document but does not meet client's internal expectations |