Check Malware Scan Status

You can check the progress and results of the scan after requesting a malware scan.

Notes

• PollingIf the inspection is in progress (code: 3), you need to check again after 500ms.
• Virus Names: If multiple viruses are detected, they are separated by commas.scanMessagewill be returned.

Method

GET

/inspection/malware/{jobId}

---

Request Path Parameter

KEY	OBJECT	DESC
jobId	String	Work ID received upon request for inspection (required)

---

Response Body (json)

KEY	OBJECT	DESC
code	int	Test Result Code (see table below)
msg	String	Result Message
jobId	String	Work ID
logReason	int	Log Reason Code
scanMessage	String	Malware Name (Optional)

---

Response Code

CODE	DESC	DESC_DETAIL
0	Inspection completed	The inspection has been completed successfully. It distinguishes between not detected (990001) or detected (990003) using logReason.
1	Inspection Exception	The scan was not executed due to file size exceeding limits, antivirus not being used, duplicate requests, or queue overflow.
2	Inspection Error	An error occurred during the inspection, such as a vaccine service communication error, engine error, or request error.
3	In Progress	A virus scan is currently in progress for the file.
5	Access Denied	The request has been blocked due to API access control.

---

Log Reason Code

This is the result returned from the status inquiry.

In Progress

code: 3

CODE	MESSAGE	DESC
990017	Waiting for vaccine inspection	The request has been received and is waiting to be processed in the queue.
990002	Vaccine test in progress	A virus scan is currently in progress for the file.

success

code: 0

CODE	MESSAGE	DESC
990001	Virus Not Detected	No virus detected.
990002	Vaccine test in progress	A virus scan is currently in progress for the file.
990003	[Blocked] Virus Detection (Delete Infected Files)	A virus has been detected in the uploaded file.

exception

code: 1

CODE	MESSAGE	DESC
990008	[Exception] Vaccine scan file size exceeded	The file size exceeds the virus scan limit, so the scan was not performed.
990010	[Exception] Duplicate Task ID Check Request	A request for inspection was not performed with the existing work ID. Please use a different work ID.
990011	[Exception] Vaccine Check Not Used	The vaccine inspection feature is disabled.
990015	[Exception] Vaccine Check Queue Overflow	The server's processing queue is full and cannot accept requests. Please try again later.

---

Error

code: 2

CODE	MESSAGE	DESC
990007	[Error] Vaccine Service Communication Error	An error occurred during the vaccine service and communication process, preventing the inspection.
990013	[Error] Vaccine Service Error	An error occurred during the inspection process of the vaccine engine, and it could not be inspected.
990014	[Error] Vaccine Inspection Request Error	An error occurred before the request to the vaccine service, so it could not be checked.
990016	[Error] Vaccine scan timeout	The inspection time for the vaccine engine has exceeded, and we cannot provide results.

---

Sample

REQUEST

curl -X GET "{{url}}/inspection/malware/8bc422e1-af1b-11f0-bf7b-7117406ac6f5"

RESPONSE - Vaccine inspection in progress (200 OK)

{
   "code": 3,
   "msg": "현재 파일에 대해 바이러스 검사를 진행 중입니다.",
   "jobId": "8bc422e1-af1b-11f0-bf7b-7117406ac6f5"
}

RESPONSE - Virus Not Detected (200 OK)

{
   "code": 0,
   "msg": "바이러스가 검출되지 않았습니다.",
   "jobId": "8bc422e1-af1b-11f0-bf7b-7117406ac6f5",
   "logReason": 990001
}

RESPONSE - [Blocked] Virus Detected (Infected File Deleted) (200 OK)

{
   "code": 0,
   "msg": "업로드하신 파일에서 바이러스가 탐지되었습니다.",
   "jobId": "f89d9593-af1b-11f0-bf7b-7117406ac6f5",
   "logReason": 990003,
   "scanMessage": "Trojan.Jeki.2"
}

RESPONSE - [Exception] Vaccine inspection file size exceeded (200 OK)

{
   "code": 1,
   "msg": "파일 크기가 백신 검사 제한 크기를 초과하여 검사가 수행되지 않았습니다.",
   "jobId": "18ae81f4-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990008
}

RESPONSE - [Exception] Vaccine Check Not Used (200 OK)

{
   "code": 1,
   "msg": "백신 검사 기능이 비활성화되어 있습니다.",
   "jobId": "7f3e9a21-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990011
}

RESPONSE - [Exception] Duplicate Work ID Check Request (200 OK)

{
   "code": 1,
   "msg": "기존에 사용된 작업 ID로, 검사 요청을 수행하지 않았습니다. 다른 작업 ID를 사용해 주세요",
   "jobId": "e3b8c7d2-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990010
}

RESPONSE - [Exception] Vaccine Check Queue Overflow (200 OK)

{
   "code": 1,
   "msg": "서버의 처리 대기열이 가득차 요청을 수락하지 못했습니다. 잠시 후 다시 시도해 주세요",
   "jobId": "c4d7f3e2-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990015
}

RESPONSE - [Error] Vaccine Service Communication Error (200 OK)

{
   "code": 2,
   "msg": "백신 서비스와 통신 과정 중 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "d5c6dd09-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990007
}

RESPONSE - [Error] Vaccine Service Error (200 OK)

{
   "code": 2,
   "msg": "백신 엔진의 검사 과정중 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "a9f2c153-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990013
}

RESPONSE - [Error] Vaccine inspection request error (200 OK)

{
   "code": 2,
   "msg": "백신 서비스로 요청 전 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "b2d1e764-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990014
}

RESPONSE - [Error] Vaccine check timeout (200 OK)

{
   "code": 2,
   "msg": "백신 엔진의 검사 시간이 초과되어 결과를 제공할 수 없습니다.",
   "jobId": "6f5a2b91-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990016
}

RESPONSE - Access Denied (200 OK)

{
   "code": 5,
   "msg": "Sanitization Request Blocked by API Access control.",
   "jobId": "52617927-af1c-11f0-bf7b-7117406ac6f5"
}

---

Processing Flow

• This flow is provided to the customer for reference only.