Docs

Get Project Revisions

gethttps://app.fossa.com/api/projects/{locator}/revisions

List Revisions for the branches and tags of a given project.

Path parameters

locatorstringrequired

the url-encoded locator of the project - matched by substring

Query parameters

offsetnumber

the number of revisions to skip per ref (branch or tag) for pagination.

countnumber

the number of revisions to return per ref (branch or tag), max 1000.

resolvedboolean

If true, we will only return Revisions that have been successfully analyzed by FOSSA (resolved)

refs[]string[]

the list of branches or tags being requested

refs_typeenum

Specify whether the list should be tags OR branches

branchtag
sourceenum

Filter the revisions by source

githubgitlabbitbucketazurecliarchivecontainersbombinary
isMinimalboolean

If `true`, each Revision in the response is reduced to only its `locator` and `message` fields. Useful for limiting response size.

locatorstring

Filter the revisions to those whose locator contains this value (case-insensitive substring match).

Responses

200A map of branches and tags of the Project to a sorted list of Revisions belonging to the corresponding tag/branch
branchobject

map of branches to their Revisions

tagobject

map of tags to their Revisions

400Bad Request
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

401Unauthorized
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

404Not Found
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

500Server Error
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

Try this endpoint

Build a request and run it against app.fossa.com.

Bearer

Stored in this browser for 24 hours. Try It uses a docs proxy for CORS and does not store tokens server-side.

GET https://app.fossa.com/api/projects/%7Blocator%7D/revisions
curl --request GET \  --url 'https://app.fossa.com/api/projects/%7Blocator%7D/revisions' \  --header 'accept: application/json' \  --header 'authorization: Bearer YOUR_API_TOKEN'

Real request. Mutating methods can change data.

Click Try It to run a request and see the response here.
Enter a Bearer token before running this request.

Path params

locatorstringrequired

the url-encoded locator of the project - matched by substring

Query params

offsetnumber

the number of revisions to skip per ref (branch or tag) for pagination.

countnumber

the number of revisions to return per ref (branch or tag), max 1000.

resolvedboolean

If true, we will only return Revisions that have been successfully analyzed by FOSSA (resolved)

refs[]array

the list of branches or tags being requested

refs_typeenum

Specify whether the list should be tags OR branches

sourceenum

Filter the revisions by source

isMinimalboolean

If `true`, each Revision in the response is reduced to only its `locator` and `message` fields. Useful for limiting response size.

locatorstring

Filter the revisions to those whose locator contains this value (case-insensitive substring match).

← All Projects endpoints