Project specs list
GET /organization/{orgId}/project/{projectId}/specs
List spec sections with version history
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
orgId*string
Organization ID — must match the project's owning org.
projectId*string
Project ID. Returned in the uid field of any project list response.
Query Parameters
includeDocumentReferences?string
When true, attach documentReferences[] to each spec section — documents (typically submittals) that reference the section by normalized division code.
Value in
"true" | "false"documentType?string
Comma-separated document_type_code values to filter the references (e.g. Submittal,RFI). Ignored when includeDocumentReferences=false.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.part3.io/v1/organization/org_8a1b2c3d4e/project/proj_5f9a3c2e8b/specs"{
"data": [
{
"uid": "spec_1a2b3c4d5e",
"divisionCode": "03",
"divisionTitle": "Concrete",
"sectionCodeTail": "30 00",
"sectionTitle": "Cast-In-Place Concrete",
"normalizedSectionCode": "033000",
"specPackageId": "pkg_8c7b6a5d4f",
"latestVersionFileId": "file_2d3e4f5a6b",
"createdAt": "2026-02-10T16:45:00Z",
"versions": [
{
"fileId": "file_2d3e4f5a6b",
"fileName": "03 30 00 - Cast-In-Place Concrete.pdf",
"fileThumbnailUrl": null,
"issueDate": "2026-02-10",
"pageCount": 18,
"sourceImportJobUid": "job_5d4c3b2a1f",
"sourceImportJobName": "Specs Issued for Construction — 2026-02-10",
"createdAt": "2026-02-10T16:45:00Z"
}
],
"documentReferences": [
{
"uid": "doc_9a8b7c6d5e",
"id": "SUBM-021",
"title": "Concrete mix designs",
"type": "Submittal",
"status": "with-consultants"
}
]
}
]
}{
"error": "Insufficient permissions"
}{
"error": "Insufficient permissions"
}