10 Apr 2025

ACC Admin API: new API to list all projects for a specified user

Default blog image

We’re excited to announce a new API enhancement that allows you to retrieve all projects associated with a specific user in a more efficient way.

What's New?

Previously, there wasn’t a straightforward method to get all the projects a particular user was involved in. Developers had to:

  1. List all projects within the account
  2. Iterate through each project to check if the user was a member

This approach was tedious and inefficient. With this new API, you can now fetch all the projects a user participates in with a single request — and even apply filters to narrow down the results.

Key Highlights

  • Supports both ACC and BIM 360 projects
  • Efficient: No need to loop through all projects manually
  • Flexible filtering options to fine-tune your queries

Important Notes

This API involves two types of user IDs:

  • User-Id (Header parameter): This represents the user on whose behalf the request is being made.

    • Must be an Account Admin
    • Not needed for 3-legged OAuth
    • For 2-legged OAuth, it's optional, required if you want to specify an admin user, but you can also ignore this if don't want to specify an admin user.
  • userId (URI parameter): This is the ID of the user whose projects you want to retrieve.

Related Article