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.

Send Accept: text/csv to get a streaming CSV export of the filtered cross-org result set instead of JSON. The CSV path honors every filter on this endpoint, ignores cursor, and applies limit if explicit (default 100,000, hard cap 100,000). include-enrichments and activitySummary are omitted from CSV in v1.

Authorization

bearer

AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

Pagination cursor

limit?string

Max rows in this response. JSON: 1–50 (default 25), paginate via cursor. CSV (Accept: text/csv): 1–100,000 (default 100,000 — the cap).

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, fileCount, drawingCount, specCount

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",
      "organizationId": "org_8a1b2c3d4e",
      "organizationName": "Stanford Partners",
      "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",
      "lastActivity": "2026-04-22T11:00:00Z",
      "documentCount": 142,
      "contactCount": 28,
      "documentsByType": {
        "RFI": 18,
        "Submittal": 64,
        "ChangeOrder": 9
      },
      "reportsByType": {
        "SiteReport": 12,
        "ProgressReport": 4
      },
      "fileCount": 312,
      "drawingCount": 24,
      "specCount": 56,
      "recentActivity": {},
      "activitySummary": [
        {}
      ]
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

{
  "error": "Insufficient permissions"
}

{
  "error": "Insufficient permissions"
}

Projects list

Authorization

Query Parameters

Response Body

200application/json

400application/json

403application/json

`application/json`

`application/json`