Download API definition:

GET https://sampleHostName/projects/[?projectNumber][&displayName][&$search][&$top][&$skip]

Retrieves a list of projects that can be accessed by the loggged in user. The user is determined by the authentication token. See the Authorization section for information on how access rights are determined.


Requires Authorization header with valid Bearer token for scope projects:read.

For more documentation on authorization and how to get access token visit OAUTH2 Authorization page.


User must be an Organization Administrator for the Organization that owns a given project or be a project team member.

An Organization Administrator must have at least one of the following roles assigned in User Management: Account Administrator, Co-Administrator, or CONNECT Services Administrator. For more information about User Management please visit our Bentley Communities Licensing, Cloud, and Web Services wiki page.


By default, each project in the returned list of projects will have only the project id, display name and project number.

A full representation of each project can be returned by specifying the prefer header that includes a value of return=representation.