Skip to content
Webhooks

Scan Completed

The completed event occurs once the scan process has been completed and the scan finished successfully.


status integer

The current status of the scan. Possible values: 0 (Success), 1 (Error), 2 (CreditsChecked), 3 (Indexed)

developerPayload string

The developer payload that was provided in the submit method.


<= 512 characters

scannedDocument object

General information about the scanned document.

scanId string

The unique scan id provided by you.

totalWords integer

Unsigned Integer


Total number of words found in the scanned text.

totalExcluded integer

Unsigned Integer


Number of excluded words in the submitted content.

credits integer

Overall credits used for the scan.

creationTime string<date-time>

The creation time of the scan.


Timezone: UTC+0

metadata object
finalUrl string<uri>

The submitted url after all http redirects.

canonicalUrl string<uri>

Extracted canonical url from the scanned document.

publishDate string<date-time>

Publication date of the scanned document.

creationDate string<date-time>

Creation date of the scanned document.

lastModificationDate string<date-time>

Last modification date of the scanned document.

author string

Scanned document author.

organization string

Scanned document organization.

filename string

Scanned document filename.

results object

A list of all the results that were found.

internet object
id string

Unique result ID to identify the result.

title string

Document title. Mostly extracted from the document content.

introduction string

Document brief introduction. Mostly extracted from the document content.

matchedWords integer

Unsigned Integer


Total matched words between this result and the scanned document.

url string<uri>

Public URL of the resource.

metadata object
tags array[object]
database object
id integer

Unique result ID to identify this result.

title string

Document title. Mostly extracted from the document content.

introduction string

Document brief introduction. Mostly extracted from the document content.

matchedWords integer

Unsigned Integer


Total matched words between this result and the scanned document.

scanId string

In case a result was found in the Copyleaks internal database, and was submitted by you, this will show the scan id of the specific result. Otherwise, this field will remain empty.

metadata object
finalUrl string<uri>

Final result url after all http redirects.

canonicalUrl string<uri>

Extracted canonical url from the result.

publishDate string<date-time>

Publication date of the result.

creationDate string<date-time>

Creation date of the result.

lastModificationDate string<date-time>

Last modification date of the result.

author string

Result author.

organization string

Result organization.

filename string

Result filename.

tags array[object]
code string

Unique ID that signifies the type of result tag.

title string

A simple name for this tag.

description string

Short text describing this tag.

batch object
id string

Unique result ID to identify this result.

title string

Document title. Mostly extracted from the document content.

introduction string

Document brief introduction. Mostly extracted from the document content.

matchedWords integer

Unsigned Integer


Total matched words between this result and the scanned document.

scanId string

The batch id that is unique for all scans in this batch.

metadata object
finalUrl string<uri>

Final result url after all http redirects.

canonicalUrl string<uri>

Extracted canonical url from the result.

publishDate string<date-time>

Publication date of the result.

creationDate string<date-time>

Creation date of the result.

lastModificationDate string<date-time>

Last modification date of the result.

author string

Result author.

organization string

Result organization.

filename string

Result filename.

tags array[object]
code string

Unique ID that signifies the type of result tag.

title string

A simple name for this tag.

description string

Short text describing this tag.

repositories object
id string

Unique result ID to identify this result.

title string

Document title. Mostly extracted from the document content.

introduction string

Document brief introduction. Mostly extracted from the document content.

matchedWords integer

Unsigned Integer


Total matched words between this result and the scanned document.

repositoryId string

The repository Id that has the result.

scanId string

The scanId of the matched results in the repository.

metadata object
finalUrl string<uri>

Final result url after all http redirects.

canonicalUrl string<uri>

Extracted canonical url from the result.

publishDate string<date-time>

Publication date of the result.

creationDate string<date-time>

Creation date of the result.

lastModificationDate string<date-time>

Last modification date of the result.

author string

Result author.

organization string

Result organization.

filename string

Result filename.

submittedBy string

Email of the user which added this document to the repository.

tags array[object]
code string

Unique ID that signifies the type of result tag.

title string

A simple name for this tag.

description string

Short text describing this tag.

score object

The aggregated score of all results.

identicalWords integer

Unsigned Integer


Number of words which matched exactly

minorChangedWords integer

Unsigned Integer


Number of nearly identical words with small differences like ‘slow’ and ‘slowly’.

relatedMeaningWords integer

Unsigned Integer


Number of paraphrased words showing similar ideas with different words.

aggregatedScore number<float>

Unsigned float


The percentage of similar words from all results. The calculation does not include excluded references, quotations, etc…

notifications object

A list of all the notifications that were found.

alerts array[object]

A list of scan alerts that were detected in the scan. See more about Alert Types

category integer

Scan alert category.

code string

Scan alert code. The code is unique for each scan alert.

title string

Scan alert human-readable title.

message string

Provides human-readable information about the scan alert.

helpLink string

Url to a resource describing the specific scan alert.

severity integer

Unsigned Integer


Specifies the importance of the scan alert.



Possible values:


0 : Very Low


1 : Low


2 : Medium


3 : High


4 : Very High

additionalData string

Additional data about the scan alert. Supplied as a json string.

{
"status": 0,
"developerPayload": "Custom developer payload",
"scannedDocument": {
"scanId": "string",
"totalWords": 0,
"totalExcluded": 0,
"credits": 0,
"creationTime": "string",
"metadata": {
"finalUrl": "string",
"canonicalUrl": "string",
"author": "string",
"organization": "string",
"filename": "string",
"publishDate": "string",
"creationDate": "string",
"lastModificationDate": "string"
}
},
"results": {
"internet": [
{
"id": "string",
"title": "string",
"introduction": "string",
"matchedWords": 0,
"url": "string",
"metadata": {
"finalUrl": "string",
"canonicalUrl": "string",
"author": "string",
"organization": "string",
"filename": "string",
"publishDate": "string",
"creationDate": "string",
"lastModificationDate": "string"
}
}
],
"database": [
{
"id": "string",
"title": "string",
"introduction": "string",
"matchedWords": 0,
"scanId": "string",
"metadata": {
"finalUrl": "string",
"canonicalUrl": "string",
"author": "string",
"organization": "string",
"filename": "string",
"publishDate": "string",
"creationDate": "string",
"lastModificationDate": "string"
}
}
],
"batch": [
{
"id": "string",
"title": "string",
"introduction": "string",
"matchedWords": 0,
"scanId": "string",
"metadata": {
"finalUrl": "string",
"canonicalUrl": "string",
"author": "string",
"organization": "string",
"filename": "string",
"publishDate": "string",
"creationDate": "string",
"lastModificationDate": "string"
}
}
],
"repositories": [
{
"id": "string",
"title": "string",
"introduction": "string",
"matchedWords": 0,
"repositoryId": "string",
"scanId": "string",
"metadata": {
"finalUrl": "string",
"canonicalUrl": "string",
"author": "string",
"organization": "string",
"filename": "string",
"publishDate": "string",
"creationDate": "string",
"lastModificationDate": "string",
"submittedBy": "string"
}
}
],
"score": {
"identicalWords": 0,
"minorChangedWords": 0,
"relatedMeaningWords": 0,
"aggregatedScore": 0
}
},
"downloadableReport": {
"status": "Success = 0",
"report": "string"
},
"notifications": {
"alerts": [
{
"category": 2,
"code": "string",
"title": "string",
"message": "string",
"helpLink": "string",
"severity": 0,
"additionalData": "string"
}
]
}
}