Run Forensic Analysis
Triggers forensic analysis for a tenant.
Automatic Forensic Handling
In most cases, forensic analysis is automatically managed by SKOR once all required prerequisites (such as document upload and KYC completion) are satisfied.
Asynchronous Operation
This endpoint initiates an asynchronous process. The API response immediately returns the current forensic processing status for the tenant and indicates whether the tenant has been added to the forensic queue. Forensic analysis itself is performed in the background. Completion of forensic analysis is communicated via webhook events and later can be inferred from the Get API response.
This endpoint does not wait for forensic analysis to complete. Completion of forensic analysis is communicated separately via webhook events.
This endpoint attempts to add the tenant to the forensic processing queue. Depending on the tenant’s current state, the request may not be queued and will instead return a status explaining why.
Possible statuses returned:
-
PENDING The tenant is already in the forensic queue and is waiting for their turn to be picked up by the processor.
-
PROCESSING Forensic analysis is currently running for the tenant. Skor Lite is actively processing the job.
-
DOCUMENTS_ANALYSIS_NOT_FOUND No documents are available for analysis and no document analysis has been performed yet.
-
KYC_PENDING Identity verification (KYC) has not been completed yet.
-
QUEUED The tenant has been successfully added to the forensic processing queue and will be processed shortly.
Queue behavior:
- If the status is PENDING or PROCESSING, the tenant is already in the queue or being processed.
- If the status is DOCUMENTS_ANALYSIS_NOT_FOUND or KYC_PENDING, the tenant is not added to the queue.
- In all other valid cases, the tenant is added to the forensic queue for processing.
Forensic completion webhook:
When forensic analysis from Skor Lite is completed successfully, a webhook event
FORENSIC_ANALYSIS_DATA is sent.
The webhook payload contains:
event: Event name (FORENSIC_ANALYSIS_DATA)data: Forensic analysis result data
The configured webhook endpoint must accept POST requests.
Authorizations
HTTP Bearer Authentication. Pass the token generated via
/keys/generate-token as Authorization: Bearer <token>.