Part3 Developers

Reports list

GET /organization/{orgId}/project/{projectId}/reports

List reports in a project

GET
/organization/{orgId}/project/{projectId}/reports
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string

Organization ID. For web-app users it is the active org context; for OAuth clients it is a scoped org.

projectId*string

Project ID. Returned from GET /v1/organization/{orgId}/project. Must belong to the org in the path.

Query Parameters

cursor?string

Cursor for the next page. Pass back the nextCursor from a prior response. Omit on the first page.

limit?string

Page size, 1–50 (default 25). Sent as a string.

sortBy?string

Sort field. createdAt (default) for recently-created feeds; date for the report/meeting date; title for alphabetical.

Value in"createdAt" | "date" | "title"
sortOrder?string

Sort direction. Default desc (newest first).

Value in"asc" | "desc"
search?string

Full-text search across report title and location.

Lengthlength <= 500
type?string

Filter by report type. Comma-separated for OR semantics. Values: report (field report), minute (meeting minutes), site_instruction.

status?string

Filter by status. Comma-separated for OR semantics. Values: draft, issued.

includeMeta?string

Pass true to include meta.filters (enum values + labels) for building filter controls.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.part3.io/v1/organization/org_8a1b2c3d4e/project/proj_5f9a3c2e8b/reports"
{
  "data": [
    {
      "uid": "rep_2a3b4c5d6e",
      "type": "report",
      "format": "report",
      "status": "issued",
      "title": "Weekly site walk — Level 4",
      "date": "2026-04-21T00:00:00Z",
      "location": "Level 4",
      "version": "1.0",
      "isLatestVersion": true,
      "createdAt": "2026-04-21T13:50:00Z",
      "createdByName": "Anika Patel",
      "projectId": "proj_5f9a3c2e8b",
      "projectName": "Maple Heights Tower",
      "organizationId": "org_8a1b2c3d4e",
      "organizationName": "Stanford Partners",
      "sectionCount": 3,
      "itemCount": 12
    }
  ],
  "nextCursor": "eyJzIjoiMjAyNi0wNC0yMVQxMzo1MDowMFoiLCJpZCI6InJlcF8xMjMifQ",
  "hasMore": true,
  "total": 42
}
{
  "error": "Insufficient permissions"
}
{
  "error": "Insufficient permissions"
}