Skip to main content

Results Structure

Key Fields

Match Information

  • component - Name of detected component
  • matched - Similarity percentage (e.g., “95%”)
  • lines - Line range in your file
  • oss_lines - Line range in the original component
  • id - Match type (“snippet”, “file”, or “none”)
  • status - Detection status (“pending”, “identified”, etc.)

Component Details

  • vendor - Component maintainer
  • version - Detected version
  • latest - Most recent available version
  • url - Repository URL
  • purl - Package URL identifiers
  • release_date - Version release date

License Information

  • name - License identifier (e.g., “MIT”, “GPL-2.0-only”)
  • copyleft - Whether derivative works must use same license
  • patent_hints - Whether license contains patent clauses
  • source - Where license was detected (e.g., “component_declared”, “file_spdx_tag”)
  • incompatible_with - Conflicting licenses

Understanding the Match Percentage

The matched field represents the proportion of your scanned file that matches known open source code. It helps you understand how much of your code is derived from or similar to existing open source components, and whether you need to review licensing and compliance requirements.

Calculation Method

The match percentage is calculated using the following formula: Matched Percentage = (Matched Snippet Lines / Total File Lines) × 100 Example Calculation: Consider a file with the following characteristics:
  • Total file lines: 2,557
  • Matched snippet lines: 2,335
The snippet match percentage would be: (2,335 ÷ 2,557) × 100 = 91% This means that SCANOSS was able to match 91% of the scanned file against known open source code in the knowledge base.

Determining Matched Snippet Lines

Each matched snippet’s lines field specifies the range of lines matched in the original file, for example: "lines": "36-1082" This indicates that lines 36 through 1082 of the file were matched against open source components in the SCANOSS knowledge base. To calculate the total number of matched lines for this snippet: Matched Snippet Lines = End Line - Start Line + 1
The +1 is required because the range is inclusive of both the start and end lines.
Example calculation: 1082 - 36 + 1 = 1047 Matched Lines These matched lines are then used to calculate the match percentage. Assuming the file has 1,083 total lines: Matched Percentage = (1,047 / 1,083) × 100 = 96%