> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanoss.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Output Formats

> SCANOSS-PY outputs scan results in multiple industry-standard formats, including CycloneDX, SPDX Lite, CSV, and the default JSON format.

SCANOSS supports multiple output formats to integrate with your existing workflows and compliance tooling. You can specify the desired format during a scan, or convert existing scan results to a different format after the fact.

## Available Output Formats

| Format             | Description                                                | Use Case                                   |
| ------------------ | ---------------------------------------------------------- | ------------------------------------------ |
| **JSON (Default)** | Complete scan results in SCANOSS native format             | Programmatic processing, detailed analysis |
| **CycloneDX**      | Industry-standard Software Bill of Materials (SBOM) format | SBOM exchange, vulnerability tracking      |
| **SPDX Lite**      | Standardised subset of the SPDX specification              | Licence compliance, SPDX-based workflows   |
| **CSV**            | Comma-separated values                                     | Spreadsheet analysis, reporting            |

## JSON (Default)

The default output format, containing the full set of fields returned by the SCANOSS engine, including match type, component metadata, and licence data.

### Generate During Scan

```bash theme={null}
scanoss-py scan -o results.json /path/to/project
```

## CycloneDX

CycloneDX is an OWASP-maintained SBOM (Software Bill of Materials) standard used for component inventory, vulnerability tracking, and supply chain transparency.

> **Note:** The output file uses a `.json` extension regardless of the format flag, as CycloneDX supports JSON serialisation.

### Generate During Scan

```bash theme={null}
scanoss-py scan --format cyclonedx -o sbom.json /path/to/project
```

## SPDX Lite

SPDX Lite is a formally defined, minimal profile of the SPDX (Software Package Data Exchange) specification. It is intended for use cases where full SPDX compliance is not required but licence data must still be communicated in a structured, interoperable format.

> **Note:** The output file uses a `.json` extension, as SPDX Lite is serialised in JSON format.

### Generate During Scan

```bash theme={null}
scanoss-py scan --format spdxlite -o sbom-spdx.json /path/to/project
```

## CSV

Outputs scan results as comma-separated values, with one row per matched component. This format is suitable for import into spreadsheet applications or reporting pipelines.

### Generate During Scan

```bash theme={null}
scanoss-py scan --format csv -o results.csv /path/to/project
```
