Skip to main content
POST
Create a submission [eu-1]

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
query_id
string | null

Optional customer-defined identifier for the submitted document, typically an internal reference ID. Must not contain PII. Used for correlating analysis results with your internal systems.

Maximum string length: 1024
pipeline_configuration
enum<string>
default:FRAUD_ONLY

Type of analysis pipeline to execute. FRAUD_ONLY runs fraud detection and also checks document quality and classifies the document. QUALITY_ONLY and CLASSIFICATION_ONLY should only be used for near-real-time quality or classification checks without fraud analysis.

Available options:
FRAUD_ONLY,
CLASSIFICATION_ONLY,
QUALITY_ONLY
enable_decision
boolean
default:false

Set to true to enable Adaptive Decision for this submission. When enabled, customizable decision outcomes are available via the /decision endpoint.

enable_submission_characteristics
boolean
default:false

Set to true to enable attachment of submission characteristics such as device, identity, and transaction metadata. When enabled, the submission_characteristics_upload_url field is included in the response.

Response

Submission created successfully

upload_url
string<uri>
required

Presigned URL where the document file should be uploaded using HTTP PUT with Content-Type set to application/octet-stream.

Example upload using curl:

submission_id
string
required

Unique identifier for this submission, generated by the Documents API. Use this ID to retrieve analysis results.

Required string length: 24 - 36
submission_characteristics_upload_url
string<uri>

URL for attaching submission characteristics to this submission. Requires an access token. May be a relative path. See the /v2/submission/{submission_id}/characteristics endpoint for details.