GET /rest/v1.0/projects/{project_id}/locations

Return a list of Locations associated with a Project.

Servers

Path parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

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

filterssearch_with_code String No

Return item(s) where the location code or the location name match the search term

filtersdepth_range String No

Return item(s) with a tree depth within the specified range.

Examples: 0...1 - Parents and children 0...2 - Parents, children, and grandchildren 1...2 - Children and grandchildren

filtersparent_id Integer No

Return location(s) with the specified parent_ids.

sort String No

Possible values:

  • "node_name"
  • "name"
  • "parent_id"
  • "created_at"
  • "updated_at"
per_page Integer No

Elements per page

filterssearch String No

Returns item(s) matching the specified search query string.

filtersupdated_at String No

Return item(s) last updated within the specified ISO 8601 datetime range. Formats: YYYY-MM-DD...YYYY-MM-DD - Date YYYY-MM-DDTHH:MM:SSZ...YYYY-MM-DDTHH:MM:SSZ - DateTime with UTC Offset YYYY-MM-DDTHH:MM:SS+XX:00...YYYY-MM-DDTHH:MM:SS+XX:00 - Datetime with Custom Offset

filterscode[] Array No

Return location(s) matching any of the specified codes in the search term.

filterssuperlocations_for Integer No

Return superlocations (ancestors) of the specified location ids.

filtersid[] Array No

Return item(s) with the specified IDs.

filterssublocations_for Integer No

Return sublocations (descendants) of the specified location 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.