Downloading attribution reports — FOSSA Docs Docs Search docs... ⌘K
Docs API CLI Glossary
Launch App
User Guides
Product Guides
Get Started
Project Setup
Release Groups
Issues
Licenses
Vulnerabilities
Quality
SBOM
Policies
Reports
FOSSA CLI
API Reference
Introduction to the FOSSA API Authentication Errors Webhook Notifications CPE Lookup API Usage examples
Managing issues Managing users and teams Initiating a binary scan Generating reports Creating Jira tickets Downloading attribution reports Modifying release groups Retrieving the latest revision Rotating access tokens
Endpoint Reference
Integrations
fossabot
Organization Management
On-Premises Deployment
Help & Support
Legal
Get Support fossa.com
On this page
* Overview
* Adding a custom report header (optional)
* Endpoints by format
* Example: download an HTML report
* Choosing what the report includes
* Related
On this page
Docs API Reference Usage examples Downloading attribution reports Downloading attribution reports
Download project attribution (licensing) reports in TXT, HTML, Markdown, PDF, or CSV.
2 min read Updated Aug 26, 2026 Copy link
Overview
This recipe shows how to download a project 's attribution report (typically a licensing report) in several formats.
Note
* A FOSSA API token , see Authentication .
* The project locator or revision ID of the project you want to report on, see Retrieving the latest revision .
Adding a custom report header (optional)
To add custom text to the top of your report, open Project Settings > Reports and enter it in the Description field (Markdown is supported). Once configured, the custom text appears at the top of the generated attribution report.
Expand
Endpoints by format
Some formats are emailed to your account; others download directly to your machine. Replace {revision_id} with your URL-encoded revision locator.
Format Delivery Endpoint
Plain text Emailed GET /api/revisions/{revision_id}/attribution/email?format=TXT
PDF Emailed GET /api/revisions/{revision_id}/attribution/email?format=PDF
HTML Download GET /api/revisions/{revision_id}/attribution/download?download=true&format=HTML
Markdown Download GET /api/revisions/{revision_id}/attribution/download?download=true&format=MD
CSV Download GET /api/revisions/{revision_id}/attribution/download?download=true&format=CSV
Example: download an HTML report
Shell Copy
curl --request GET \ --url 'https://app.fossa.com/api/revisions/{revision_id}/attribution/download?download=true&format=HTML' \ --header 'Authorization: Bearer YOUR_API_KEY'
Choosing what the report includes
Pass dependencyInfoOptions[] one or more times to control which fields appear per dependency . Available values:
* Library
* Authors
* Description
* ConcludedLicense
* License
* CustomTextLicense
* FullTextLicense
* OtherLicenses
* FilePath
* Source
* ProjectUrl
* PackageDownloadUrl
* DependencyPaths
* IssueNotes
* Copyrights
* NoticeFiles
* LicenseFileURL
Some values depend on features being enabled for your organization (for example, ConcludedLicense requires license conclusions and FilePath requires file paths in reports).
Related
* Managing issues : query issues programmatically.
* Retrieving the latest revision : get the revision ID for a project.
Previous Creating Jira tickets Next Generating reports
© 2026 FOSSA, Inc.
[email protected]