FILE ANALYSIS API

File analysis
for malware research.

Submit a file to retrieve a detection label, hashes and analysis metadata. Add the results to upload review, malware research or security investigations.

5 credits / checkFile uploadJSON response
EXAMPLE RESULTFILE ANALYSIS
sample.exe
Trojan.Example

The detection is attached to the file you submitted.

SHA-256
8f4c2a1b…8f4c2a1b
File size
24,576 bytes
Malicious flag
true
Harmless flag
false

Illustrative response · synthetic file and detection label

FROM UPLOAD TO TRIAGE

File analysis
for security workflows.

Attach file identity and detection results to upload reviews, security alerts and investigation records.

01

Submit the file

Your backend uploads the actual file with its API key using multipart/form-data.

02

Attach the finding

Store the detection, hashes and file metadata alongside an upload, alert or investigation record.

03

Route the next action

Use the result to prioritize review, escalate a detection or enrich your security tooling.

WHAT YOUR APPLICATION RECEIVES

File identity
and analysis results.

The same endpoint serves every API plan. Your plan determines the depth of analysis returned.

Response layerWhat it gives youAvailable on
File identity & detectionSHA-256, MD5, filename, size, detection label and malicious / harmless flags.All plans
Executable analysisThe PE block with available Portable Executable analysis.Paid plans
Heuristic criteriaAvailable 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.

START BUILDING

Integrate the
File Analysis API.

Upload a file from your server and map the returned JSON fields to your file review or investigation logic.

5 credits / successful checkCompare API plans
POST /api/v1/file/check
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 licensing & submission handling

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 privacy choices. Essential storage supports your account. Optional analytics helps us improve public product pages. Privacy details