Projects list

GET /admin/projects

List projects platform-wide with filtering by organization, type, and archived status. Use this for a project directory or portfolio view across organizations. Use include=documentCount,contactCount for aggregate stats, or include=documentsByType,reportsByType for per-type counts. Project types: CA (construction administration), SR (submittal review). Use activitySummary for a rough busyness/aliveness view over time based on recorded project activity. Use the document-summary endpoint per-project for document count breakdowns. For complex queries, counts, or aggregations across entities, use the explorer_query tool instead.

Authorization

bearer

AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

Pagination cursor

limit?string

Page size (1-50, default 25)

sortBy?string

Sort field. Supported: name, lastActivity, createdAt, updatedAt. lastActivity sorts by the project's most recent recorded activity. Unsupported values fall back to createdAt.

sortOrder?string

Sort direction (default: desc)

Value in"asc" | "desc"

search?string

Search by project name (ILIKE)

Lengthlength <= 500

organizationId?string

Filter by organization ID

include?string

Comma-separated list of optional aggregate fields to include. Available: documentCount, contactCount, documentsByType, reportsByType

activitySummary?string

Include activity summary buckets for recent project activity. weekly=7×1day, monthly=4×7day, yearly=12×1month. Activity means recorded actions such as document distribution, comments, and other tracked project events.

Value in"weekly" | "monthly" | "yearly"

filter.name?string

Lengthlength <= 500

filter.organizationName?string

Lengthlength <= 500

filter.type?string

Lengthlength <= 500

filter.archived?string

Lengthlength <= 20

filter.createdAt?string

Lengthlength <= 25

includeRecentActivity?string

Include recent activity for each project. Value is the time window: 1d (1 day), 5d, 1w, 2w, 4w.

Value in"1d" | "5d" | "1w" | "2w" | "4w"

activityActions?string

Comma-separated action types to filter recent activity (e.g., createDocument,issueDocument). Requires includeRecentActivity.

Lengthlength <= 500

includeMeta?string

Include meta.filters with enum values for filterable columns

Value in"true"

Response Body

`application/json`

curl -X GET "https://api.part3.io/v1/admin/projects"

{
  "data": [
    {
      "uid": "proj_5f9a3c2e8b",
      "name": "Maple Heights Tower",
      "nameShorthand": "MHT",
      "address": "120 Front St W, Toronto, ON",
      "timezone": "America/Toronto",
      "archived": false,
      "type": "CA",
      "startDate": "2026-01-15T00:00:00Z",
      "endDate": "2027-06-30T00:00:00Z",
      "createdAt": "2026-01-08T19:24:00Z",
      "updatedAt": "2026-04-22T11:00:00Z",
      "documentCount": 142,
      "contactCount": 28,
      "documentsByType": {
        "RFI": 18,
        "Submittal": 64,
        "ChangeOrder": 9
      },
      "reportsByType": {
        "SiteReport": 12,
        "ProgressReport": 4
      }
    },
    {
      "uid": "proj_4e8b2d1f9c",
      "name": "Riverside Mixed-Use",
      "nameShorthand": "RMU",
      "address": "88 River Rd, Calgary, AB",
      "timezone": "America/Edmonton",
      "archived": false,
      "type": "CA",
      "startDate": "2025-09-01T00:00:00Z",
      "endDate": "2026-12-31T00:00:00Z",
      "createdAt": "2025-08-19T15:02:00Z",
      "updatedAt": "2026-04-21T10:18:00Z"
    }
  ],
  "nextCursor": "eyJzIjoiMjAyNS0wOC0xOVQxNTowMjowMFoiLCJpZCI6InByb2pfNGU4YjJkMWY5YyJ9",
  "hasMore": true
}

{
  "error": "Insufficient permissions"
}

{
  "error": "Insufficient permissions"
}

Projects list

Authorization

Query Parameters

Response Body

200application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`