Project specs list
GET /admin/projects/{projectId}/specs
List all spec sections for a project with version history. Each spec section includes division code, title, section code, and all version files with page counts and issue dates. Use ?includeDocumentReferences=true to include submittals that reference each spec section by division code.
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
projectId*string
Project UID
Query Parameters
includeDocumentReferences?string
Include submittals that reference each spec section by division code
Value in
"true" | "false"documentType?string
Comma-separated document types to filter references (e.g. "Submittal,RFI"). Only applies when includeDocumentReferences=true.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.part3.io/v1/admin/projects/string/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"
}