Developers
Integrate document scanning with a single HTTP call. No SDK — it is just HTTP.
Try it now
Upload a document and see the live verdict. Requests go to https://aws.geneav.com.
Drop a document here, or browse
PDF, Office docs, text, ZIP · up to 25 MB
Scan a document
The request shape:
POST /api/v1/scan
Content-Type: multipart/form-data
field: file=<your document>Example:
curl -F "file=@invoice.pdf" https://aws.geneav.com/api/v1/scanResponse 200 OK:
{
"scanId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "infected",
"threat": "Eicar-Test-Signature",
"fileName": "invoice.pdf",
"fileSize": 68,
"contentType": "application/pdf",
"scannedAt": "2026-07-04T06:47:00Z"
}Errors
Failures are explicit — nothing fails silently.
400
No file provided or the file is empty.
413
File exceeds the maximum allowed size (25 MB).
415
Unsupported content type.
402
Monthly scan quota exhausted for this API key.
429
Rate limit exceeded. Retry after the interval in the header.
503
Scan engine unavailable.
Health
GET /api/v1/health -> { "status": "UP", "engine": "UP" }