Projects
List Projects
Retrieves a paginated list of projects with optional filters
Retrieves a paginated list of projects with optional filters
Query Parameters
teamId?string
Filter by team ID
ownerId?string
Filter by owner ID
statusId?string
Filter by status ID
collectionId?string
Filter by collection ID
includeArchived?string
Include archived projects
includeTotal?string
Include total count in response. Consider omitting for subsequent page loads to improve performance.
includeMarkdown?string
Include description.markdown field. Omit for better performance when markdown is not needed.
expand?|||array<>
Expansion fields: "all" (full enrichment, default), "none" (IDs only), or comma-separated/repeated fields (owner,status,teams,collection)
cursor?string
Cursor for pagination
offset?|
Offset for pagination
limit?integer
Number of results to return (max 100)
Response Body
application/json
curl -X GET "https://example.com/v1/projects/list"{ "data": [ { "id": "string", "publicId": "string", "name": "string", "slug": "string", "icon": "string", "startDate": "2019-08-24T14:15:22Z", "dueDate": "2019-08-24T14:15:22Z", "ownerId": "string", "collectionId": "string", "workspaceId": "string", "statusId": "string", "archivedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "teamIds": [ "string" ], "description": { "html": "string", "markdown": "string" }, "color": "string", "owner": { "id": "string", "name": "string", "email": "string" }, "status": { "id": "string", "name": "string", "color": "string", "icon": "string" }, "teams": [ { "id": "string", "name": "string", "publicId": "str" } ], "collection": { "id": "string", "name": "string" } } ], "nextCursor": "string", "hasMore": true, "total": 0}