Submittals list
GET /admin/documents/submittals
List submittals with format-specific fields (division, review status, consultants, people, ball-in-court). Same filtering/pagination as the generic document list but scoped to submittals.
Authorization
bearer In: header
Query Parameters
Pagination cursor
Page size (1-50, default 25)
Sort field. Supported: createdAt, updatedAt, dueDate, title, receivedAt, closedAt.
Sort direction (default: desc)
"asc" | "desc"Filter by document status (comma-separated)
length <= 500Full-text search across title, number, description, comments, review responses, responder names/emails, and division titles
length <= 500Filter by project ID
Filter by organization ID
length <= 500length <= 500length <= 25length <= 25length <= 25length <= 25Restrict to submittals that HAVE active AI-review findings. high = a spec-compliance finding with severity mismatch OR a quality finding with severity required; any = any active finding of either source. Active = not soft-deleted and not dismissed (findings accumulate across review runs; a superseded or spec-removed finding is soft-deleted and drops out). Composes with filter.status. Pair with include=reviewHints to embed the findings themselves.
"high" | "any"Comma-separated optional fields to embed per row. Available: reviewHints — the submittal's active AI-review findings (spec-compliance + quality), normalized into a single shape. Strictly opt-in: omit for the default (unenriched) list. When filter.reviewHint is also set, the embedded findings use the same severity lens; otherwise all active findings are embedded.
length <= 500Include meta.filters with enum values for filterable columns
"true"Response Body
application/json
curl -X GET "https://api.part3.io/v1/admin/documents/submittals"{
"data": [
{
"uid": "string",
"id": null,
"format": "string",
"type": "string",
"title": null,
"status": "string",
"priority": null,
"dueDate": null,
"issuedAt": null,
"createdAt": null,
"updatedAt": null,
"projectId": "string",
"projectName": null,
"organizationId": null,
"organizationName": null,
"referenceNumber": null,
"divisionTitle": null,
"reviewStatus": null,
"receivedAt": null,
"closedAt": null,
"ballInCourt": null,
"assignees": [
{}
],
"approvers": [
{}
],
"distributionRecipients": [
{}
],
"consultants": [
{}
],
"reviewHints": [
{
"source": "spec",
"severity": "mismatch",
"title": "Finish mismatch",
"description": "Submitted finish does not match the specified custom paint.",
"suggestedComment": "Confirm the cabinet will be field-painted to match.",
"specSectionId": "spec_09a3f1",
"key": "contractor_stamp",
"confidence": 0.82
}
]
}
],
"total": 0,
"nextCursor": null,
"hasMore": true,
"meta": {}
}