Get Revision Scans

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

Retrieve a paginated list of scans for a given revision, ordered by scan time descending, with ties broken by id DESC for deterministic pagination. Scans are filtered to the organization that owns the revision's project, so public and private projects behave consistently. Requires an authenticated user.

Path parameters

locatorstringrequired

The URL-encoded locator of the revision

Query parameters

pageinteger

The 1-indexed page of results to return

pageSizeinteger

The number of scans to return per page (maximum 50)

Responses

200A paginated list of revision scans.

resultsobject[]required

idinteger

Unique identifier for the scan

scanned_atstring <date-time>

Timestamp when the scan was performed

scanTypeenum

The scan type. This endpoint only returns project scans.

project

revisionIdstring

The locator of the revision the scan belongs to

organizationIdinteger

The organization that owns the scan

releaseScanIdinteger

Associated release scan identifier, if any

licensingPolicyVersionIdinteger

The licensing policy version used during this scan

securityPolicyVersionIdinteger

The security policy version used during this scan

qualityPolicyVersionIdinteger

The quality policy version used during this scan

createdAtstring <date-time>

updatedAtstring <date-time>

pageintegerrequired

The current page number

pageSizeintegerrequired

The number of items requested per page

totalCountintegerrequired

The total number of scans matching the query across all pages

400Invalid pagination parameters

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

404Revision not 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.

Language

Credentials

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/revisions/custom%252B1234%252Fmy-project%2524abcd1234/scans

curl --request GET \  --url 'https://app.fossa.com/api/revisions/custom%252B1234%252Fmy-project%2524abcd1234/scans' \  --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 revision

Query params

pageinteger

The 1-indexed page of results to return

pageSizeinteger

The number of scans to return per page (maximum 50)

← All Revisions endpoints