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

Return a list of all Submittals from a specified Project.

See Filtering on List Actions for information on using the filtering capabilities provided by this endpoint. See Downloading attachments with markup.

Servers

https://api.procore.com

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
`filterstype[]`	Array	No	Array of Submittal Types. A single Submittal Type is also accepted.
`filterscreated_at`	String	No	Return item(s) created 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
`filtersnumber[]`	Array	No	Array of Numbers. A single Number is also accepted.
`sort`	String	No	Possible values: `"due_date"` `"responsible_contractor"` `"distributed_at"` `"type"` `"title"` `"submittal_package"` `"status"` `"received_from"` `"received_date"` `"specification_section"` `"submit_by"` `"number"`
`filterstask_id[]`	Array	No	Array of Submittal Task IDs. Returns item(s) associated with the specified Submittal Task IDs. A single integer value is also accepted.
`filtersrequired_on_site_date[]`	Array	No	Array of dates (date range). Returns item(s) with their required on site date withing the specified dates. A single date is also accepted. style: form
`filtersresponsible_contractor_id`	Integer	No	Responsible Contractor ID
`filterslocation_id[]`	Array	No	Array of Location IDs. A single Location ID is also accepted.
`filtersdivision[]`	Array	No	Array of Divisions to filter on. A Division is the first two digits from the Specification Section Number. A single Division is also accepted.
`page`	Integer	No	Page
`filtersreceived_from_id`	Integer	No	Received From ID
`filterssubmittal_manager_id[]`	Array	No	Array of Submittal Manager IDs. A single Submittal Manager ID is also accepted.
`filterssubmittal_package_id[]`	Array	No	Array of Submittal Package IDs. Returns item(s) associated with the specified Submittal Package IDs. A single integer value is also accepted.
`filterscurrent_revision`	Boolean	No	Default false. If true, only current revisions are shown. If false, all submittals are shown, regardless of whether or not it is the current revision.
`filtersstatus_id[]`	Array	No	Array of Status IDs. A single Status ID is also accepted.
`filtersunpackaged`	Boolean	No	Parseable to boolean value, filters out unpackaged Submittals.
`filtersapprover_id[]`	Array	No	Array of User IDs. Return item(s) where the specified User IDs are in the approver list. A single integer is also accepted.
`per_page`	Integer	No	Elements per page
`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
`filtersball_in_court_id`	Integer	No	User ID. Return item(s) where the specified User ID is the Ball in Court.
`filtersspecification_section_id[]`	Array	No	Array of Specification Section IDs. A single Specification Section ID is also accepted.
`filtersresponse_id[]`	Array	No	Array of Response IDs. A single Response ID is also accepted.
`filtersid[]`	Array	No	Return item(s) with the specified IDs.
`filtersquery`	String	No	Return item(s) containing search query

How to start integrating

Add HTTP Task to your workflow definition.
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.
Click Test request to test run your request to the API and see the API's response.