Skip to main content
POST
/
fraud-async
Fraud Detection Async
curl --request POST \
  --url https://{base_url}/fraud-async \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'files=<string>' \
  --form 'config=<string>' \
  --form force_url=true \
  --form 'webhook=<string>' \
  --form files.0='@example-file'
{
"id": "<string>",
"status": "IN_QUEUE"
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

multipart/form-data

Request body for asynchronous fraud detection.

Content-Type: multipart/form-data

Important: Complex objects (config, webhook) must be sent as JSON-stringified values.

files
required

Document source for fraud analysis (file upload, file ID with id:// prefix, or public URL)

config
string

JSON-stringified fraud detection configuration object.

Example: {"use_pro_model":true} - Use premium model for higher accuracy

All fields are optional. Contact support for advanced configuration options.

force_url
enum<string>

Force output to always use URLs for file references (true/false as string)

Available options:
true,
false
webhook
string

JSON-stringified WebhookConfig object for async result notifications. Example: {"url":"https://example.com/webhook","metadata":{"order_id":"123"}}

Response

Job queued for fraud analysis

id
string

Job identifier for status tracking

status
enum<string>

Initial job status

Available options:
IN_QUEUE,
IN_PROGRESS