Submit an asynchronous file scan
Upload a file for malware scanning. The scan continues asynchronously in the background. The response returns the initial processing state together with the created scan ID.
Use the scan ID to poll for the result through the GET endpoints.
If webhooks are enabled in the Blazelock Dashboard, webhook events are sent as the scan progresses.
Authorization
bearerAuth API key generated in the Blazelock Dashboard.
Send it in the HTTP Authorization header as Bearer <api-key>.
In: header
Header Parameters
Two-letter ISO language code used for localized human-readable response messages. Supported values:
en= Englishde= German
Request Body
multipart/form-data
Multipart form payload for an asynchronous file scan. It contains a binary file part and an attributes part encoded as JSON with the content type application/json.
TypeScript Definitions
Use the request body type in TypeScript.
Request payload for submitting an asynchronous file scan.
Response Body
application/json
application/json
curl -X POST 'https://example.com/file-scans' \ -F 'attributes={"file_name":"invoice.pdf"};type=application/json' \ -F 'file=@invoice.pdf'{
"id": "019583d8-b2e4-7b8d-9d1f-6f4cb3d0b6f1",
"external_reference_id": "invoice-4711",
"status": "processing",
"execution_mode": "async",
"file_name": "invoice.pdf",
"file_size": 245761,
"submitted_at": "2026-03-09T12:34:56.000Z"
}{
"code": "duplicate_external_reference_id",
"message": "The external reference id already exists for this integration."
}