GET /rest/v1.0/budget_view_snapshots/{budget_view_snapshot_id}/summary_rows

Return a list of all Budget View Snapshot Summary Rows for a project and budget view snapshot. The type of row returned is dependent on the value used in the group_by query param.

Note: In addition to all the fields outlined in the response, there will be an additional key for each visible standard, source, and formula column created for the particular budget view.

Servers

Path parameters

Name Type Required Description
budget_view_snapshot_id Integer Yes

Budget View Snapshot ID

Request headers

Name Type Required Description
Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
page Integer No

Page

project_id Integer Yes

Unique identifier for the project.

group_by String No

Groups the data. Value can be a comma separated string. Default is biller,root_cost_code

Possible values:

  • "biller"
  • "root_cost_code"
  • "project"
  • "cost_code"
  • "cost_code_name"
  • "category"
  • "root_cost_code_name"
cost_code_name[] Array No

Return item(s) within a specific Cost Code name or range of Cost Code names

per_page Integer No

Elements per page

root_cost_code_id[] Array No

Return item(s) within a specific Root Cost Code id or range of Root Cost Code IDs

budget_row_type String No

Return budgeted, unbudgeted or all item(s) from all budget rows for a project. Default is all. Note that when the unbudgeted or all values are supplied, the subtotals may change depending on the presence of rows that have budgeted false

Possible values:

  • "unbudgeted"
  • "budgeted"
  • "all"
category_id[] Array No

Return item(s) within a specific category id (line item type id) or range of category IDs

budget_line_item_id[] Array No

Return item(s) within a specific budget line item id or range of budget line item IDs

biller[] Array No

Return item(s) within a specific biller. Format is biller[]=id=1,type=SubJob or biller[]=id=1,type=Project

root_cost_code_name[] Array No

Return item(s) within a specific Root Cost Code name or range of Root Cost Code names

cost_code_id[] Array No

Return item(s) within a specific Cost Code id or range of Cost Code IDs

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.