How to Get a List of Projects

This tutorial will show you how to get a list of projects, and then how to get the schema to work with those projects resiliently.

Prerequisites

Before starting, ensure you have the following:

  • Access to HeavyBid Pre-Construction APIs.
  • An API Client (Client ID and Secret) used to generate an authentication token for API utilization.
  • API Client must possess necessary scopes: precon:read precon:write on token generation.
📘

Refer to the Getting Started with Request Tokens guide for details on how to authenticate.

HCSS Pre-Construction is almost entirely customizable. Users can:

  • Add fields
  • Rename fields
  • Remove fields

This flexibility comes at the cost of increased complexity. This tutorial aims to help you navigate that complexity by showing you how to get a list of projects and their associated schemas.

Step 1: Get the Business Units

API calls in Pre-Construction require a business unit id.

🔄

To get a list of business units, call the GET Business Units endpoint.

Step 2: Get a list of projects

🔄

To get projects for a business unit, call the GET Projects endpoint .

Step 3: Get the Project Schema

🔄

To get the schemas for a business unit, call the GET Schemas endpoint.