File Scans
Submit an asynchronous file scan
Upload a file for malware scanning. The scan continues asynchronously in the background and the response returns the initial processing state together with the created scan ID.
POST
/file-scansAuthorization
bearerAuth AuthorizationBearer <token>
API key generated in the Blazelock Dashboard. Send it as Authorization: Bearer <api-key>.
In: header
Header Parameters
Content-Language?string
Two-letter ISO language code used for localized human-readable response messages. Supported values:
en= Englishde= German
Value in
"en" | "de"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.
Response Body
application/json
application/json
{
"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."
}