Retrieving the latest revision — 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
* Listing a project's branches
* Reading the response
On this page
Docs API Reference Usage examples Retrieving the latest revision Retrieving the latest revision
Retrieve the latest revision for each branch of a project via the API.
1 min read Updated Aug 26, 2026 Copy link
Overview
This recipe shows how to retrieve the latest revision for each branch of a project .
Listing a project's branches
Send a GET request to the project endpoint with ref_type=branch :
Shell Copy
curl --request GET \ --url 'https://app.fossa.com/api/projects/<project-locator>?ref_type=branch' \ --header 'Authorization: Bearer YOUR_API_KEY'
Note
URL-encode the project locator , for example, custom+1234/example becomes custom%2B1234%2Fexample .
Reading the response
The response includes a references array. Each entry describes a branch and points to its latest revision:
Field Description
id The reference ID.
type The reference type (e.g. branch ).
name The branch name.
revision_id The locator of the latest revision on that branch.
project_id The project locator.
Use the revision_id value wherever a revision locator is required, for example, when downloading attribution reports or modifying release groups .
Previous Modifying release groups Next Rotating access tokens
© 2026 FOSSA, Inc.
[email protected]