# Get a difference in findings between two scans

Retrieve a list of newly introduced and/or resolved findings.

Endpoint: GET /api/v2/scans/{scanId}/difference/{previousScanId}
Version: 24.9.2.5
Security: ApiKeyAuth, Bearer

## Path parameters:

  - `scanId` (string, required)
    ID of the first scan

  - `previousScanId` (string, required)
    ID of the second (previous) scan. It has to identify a scan that is older than the one identified by scanId.

## Response 200 fields (application/json):

  - `newFindings` (array)

  - `newFindings.ageRating` (number)

  - `newFindings.azureIssue` (object)

  - `newFindings.azureIssue.project` (string)

  - `newFindings.azureIssue.workItemId` (integer)

  - `newFindings.baselineFinding` (boolean)

  - `newFindings.comments` (array)

  - `newFindings.comments.body` (string)

  - `newFindings.comments.createdBy` (string)

  - `newFindings.comments.createdTime` (string)

  - `newFindings.confidence` (integer)

  - `newFindings.createdTime` (string)

  - `newFindings.description` (string)

  - `newFindings.expiration` (string)

  - `newFindings.falsepositive` (boolean)

  - `newFindings.filter` (object)

  - `newFindings.filter.filterTypes` (array)

  - `newFindings.filter.filterTypes.code` (integer)

  - `newFindings.filter.filterTypes.name` (string)

  - `newFindings.filter.isFiltered` (boolean)

  - `newFindings.functionCalls` (array)

  - `newFindings.functionCalls.file` (string)

  - `newFindings.functionCalls.kind` (string)

  - `newFindings.functionCalls.line` (string)

  - `newFindings.functionCalls.name` (string)

  - `newFindings.functionCalls.snippet` (string)

  - `newFindings.functionCalls.startLine` (integer)

  - `newFindings.hasRemediation` (boolean)

  - `newFindings.id` (string)

  - `newFindings.inputFlow` (array)

  - `newFindings.inputFlow.file` (string)

  - `newFindings.inputFlow.kind` (string)

  - `newFindings.inputFlow.line` (string)

  - `newFindings.inputFlow.name` (string)

  - `newFindings.inputFlow.snippet` (string)

  - `newFindings.inputFlow.startLine` (integer)

  - `newFindings.inputSource` (string)

  - `newFindings.inputSourceKind` (string)

  - `newFindings.jiraIssue` (object)

  - `newFindings.jiraIssue.issueId` (string)

  - `newFindings.jiraIssue.project` (string)

  - `newFindings.language` (string)

  - `newFindings.markedForDeletion` (boolean)

  - `newFindings.orgId` (string)

  - `newFindings.prUrl` (string)

  - `newFindings.rating` (number)

  - `newFindings.reviewed` (boolean)

  - `newFindings.risk` (string)

  - `newFindings.scanId` (string)

  - `newFindings.severityRating` (number)

  - `newFindings.signature` (string)

  - `newFindings.sink` (string)

  - `newFindings.sinkFile` (string)

  - `newFindings.sinkKind` (string)

  - `newFindings.suppressMessage` (string)

  - `newFindings.suppressTime` (string)

  - `newFindings.suppressedBy` (string)

  - `newFindings.type` (object)

  - `newFindings.type.id` (integer)

  - `newFindings.type.name` (string)

  - `resolvedFindings` (array)

  - `resolvedFindings.ageRating` (number)

  - `resolvedFindings.azureIssue` (object)

  - `resolvedFindings.azureIssue.project` (string)

  - `resolvedFindings.azureIssue.workItemId` (integer)

  - `resolvedFindings.baselineFinding` (boolean)

  - `resolvedFindings.comments` (array)

  - `resolvedFindings.comments.body` (string)

  - `resolvedFindings.comments.createdBy` (string)

  - `resolvedFindings.comments.createdTime` (string)

  - `resolvedFindings.confidence` (integer)

  - `resolvedFindings.createdTime` (string)

  - `resolvedFindings.description` (string)

  - `resolvedFindings.expiration` (string)

  - `resolvedFindings.falsepositive` (boolean)

  - `resolvedFindings.filter` (object)

  - `resolvedFindings.filter.filterTypes` (array)

  - `resolvedFindings.filter.filterTypes.code` (integer)

  - `resolvedFindings.filter.filterTypes.name` (string)

  - `resolvedFindings.filter.isFiltered` (boolean)

  - `resolvedFindings.functionCalls` (array)

  - `resolvedFindings.functionCalls.file` (string)

  - `resolvedFindings.functionCalls.kind` (string)

  - `resolvedFindings.functionCalls.line` (string)

  - `resolvedFindings.functionCalls.name` (string)

  - `resolvedFindings.functionCalls.snippet` (string)

  - `resolvedFindings.functionCalls.startLine` (integer)

  - `resolvedFindings.hasRemediation` (boolean)

  - `resolvedFindings.id` (string)

  - `resolvedFindings.inputFlow` (array)

  - `resolvedFindings.inputFlow.file` (string)

  - `resolvedFindings.inputFlow.kind` (string)

  - `resolvedFindings.inputFlow.line` (string)

  - `resolvedFindings.inputFlow.name` (string)

  - `resolvedFindings.inputFlow.snippet` (string)

  - `resolvedFindings.inputFlow.startLine` (integer)

  - `resolvedFindings.inputSource` (string)

  - `resolvedFindings.inputSourceKind` (string)

  - `resolvedFindings.jiraIssue` (object)

  - `resolvedFindings.jiraIssue.issueId` (string)

  - `resolvedFindings.jiraIssue.project` (string)

  - `resolvedFindings.language` (string)

  - `resolvedFindings.markedForDeletion` (boolean)

  - `resolvedFindings.orgId` (string)

  - `resolvedFindings.prUrl` (string)

  - `resolvedFindings.rating` (number)

  - `resolvedFindings.reviewed` (boolean)

  - `resolvedFindings.risk` (string)

  - `resolvedFindings.scanId` (string)

  - `resolvedFindings.severityRating` (number)

  - `resolvedFindings.signature` (string)

  - `resolvedFindings.sink` (string)

  - `resolvedFindings.sinkFile` (string)

  - `resolvedFindings.sinkKind` (string)

  - `resolvedFindings.suppressMessage` (string)

  - `resolvedFindings.suppressTime` (string)

  - `resolvedFindings.suppressedBy` (string)

  - `resolvedFindings.type` (object)

  - `resolvedFindings.type.id` (integer)

  - `resolvedFindings.type.name` (string)

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Something went wrong"

  - `result` (string)
    Example: "error"

  - `success` (boolean)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Something went wrong"

  - `result` (string)
    Example: "error"

  - `success` (boolean)

## Response 404 fields (application/json):

  - `message` (string)
    Example: "Something went wrong"

  - `result` (string)
    Example: "error"

  - `success` (boolean)

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Something went wrong"

  - `result` (string)
    Example: "error"

  - `success` (boolean)