Get Projects

gethttps://app.fossa.com/api/v2/projects

Fetch the list of projects based on provided filters.

Query parameters

sortenum

The category to order the results by and sort direction.

title_asctitle_descissues-total_ascissues-total_desclatest-scan_asclatest-scan_desclast-analyzed_asclast-analyzed_descissues-licensing_ascissues-licensing_descissues-security_ascissues-security_descissues-quality_ascissues-quality_desc
pageinteger

The specific page of data to return

countinteger

The number of items to return in each page of results

titlestring

Filter by project name.

type[]enum[]

Filter by project type.

isPublicboolean

Filter by project being public or private.

labels[]string[]

Filter by project labels.

teamId[]array | null

Filter by one or more team IDs. Providing "null" will return all unassigned projects.

latestScaninteger

Filter by last policy scan within N days.

lastRevisionWithininteger

Filter by last revision analyzed within N days.

locators[]string[]

Filter by project locators (exact match).

includeSharedProjectsboolean

Include shared projects.

onlyIncludeSharedProjectsboolean

Only show projects that have been shared with other organizations.

urlstring

Filter by a project's URL.

Responses

200OK
totalinteger
projectsobject[]
403Forbidden
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/v2/projects
curl --request GET \  --url 'https://app.fossa.com/api/v2/projects' \  --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.

Query params

sortenum

The category to order the results by and sort direction.

pageinteger

The specific page of data to return

countinteger

The number of items to return in each page of results

titlestring

Filter by project name.

type[]array

Filter by project type.

isPublicboolean

Filter by project being public or private.

labels[]array

Filter by project labels.

teamId[]array

Filter by one or more team IDs. Providing "null" will return all unassigned projects.

latestScaninteger

Filter by last policy scan within N days.

lastRevisionWithininteger

Filter by last revision analyzed within N days.

locators[]array

Filter by project locators (exact match).

includeSharedProjectsboolean

Include shared projects.

onlyIncludeSharedProjectsboolean

Only show projects that have been shared with other organizations.

urlstring

Filter by a project's URL.