Submit the file
Your backend uploads the actual file with its API key using multipart/form-data.
Submit a file to retrieve a detection label, hashes and analysis metadata. Add the results to upload review, malware research or security investigations.
The detection is attached to the file you submitted.
8f4c2a1b…8f4c2a1btruefalse{
"sha256": "8f4c2a1b8f4c2a1b8f4c2a1b8f4c2a1b8f4c2a1b8f4c2a1b8f4c2a1b8f4c2a1b",
"md5": "2b7f5d9a2b7f5d9a2b7f5d9a2b7f5d9a",
"filename": "sample.exe",
"size": 24576,
"detection": "Trojan.Example",
"type": null,
"heuristic": {
"malicious": true,
"harmless": false,
"analysis": null
},
"PE": null
}
Illustrative response · synthetic file and detection label
Attach file identity and detection results to upload reviews, security alerts and investigation records.
Your backend uploads the actual file with its API key using multipart/form-data.
Store the detection, hashes and file metadata alongside an upload, alert or investigation record.
Use the result to prioritize review, escalate a detection or enrich your security tooling.
The same endpoint serves every API plan. Your plan determines the depth of analysis returned.
| Response layer | What it gives you | Available on |
|---|---|---|
| File identity & detection | SHA-256, MD5, filename, size, detection label and malicious / harmless flags. | All plans |
| Executable analysis | The PE block with available Portable Executable analysis. | Paid plans |
| Heuristic criteria | Available detailed criteria in heuristic.analysis. | Premium |
Clean means no detection was returned. Technical fields can be null when they do not apply or were not produced. Explore the full response schema.
Upload a file from your server and map the returned JSON fields to your file review or investigation logic.
curl -X POST 'https://inspector.gridinsoft.com/api/v1/file/check' \
-F 'apikey=YOUR_PRIVATE_APIKEY' \
-F 'file=@/path/to/sample.exe'
Upload the file itself, not its hash. cURL sets the multipart boundary automatically.
API subscriptions use our standard terms. Paying for a plan does not make submissions private or remove our rights to use and publish analysis. Private processing, customer-facing services, redistribution, and other special rights require written agreement. Discuss your requirements.
Your current allowance is exhausted. Compare the available API subscriptions or contact us about a different volume.
View plans and credit costsCompare monthly or annual billing, review your selected plan, and continue to secure checkout.
Choose a subscription