> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "List projects"
description: "List the projects visible to the authenticated user, across every workspace they belong to."
method: "GET"
endpoint: "/api/v1/projects"
order: 1
last_verified: 2026-07-27
---



`GET /api/v1/projects`

List the projects visible to the authenticated user, across every workspace they belong to.


  ### Query parameters

  - `page` _integer_ — Page number. Defaults to 1.
  - `page_size` _integer_ — Results per page, 1-100. Defaults to 20.
  - `search` _string_ — Filter by project name (substring match).
  - `order_by` _string_ — Field to sort by. Defaults to updated.
  - `order_dir` _string_ — asc or desc. Defaults to desc.
  - `language` _string_ — Filter by primary language, e.g. python or typescript.
  - `status` _string_ — Filter by project status.
  - `workspace_id` _string_ — Restrict results to a single workspace.
  - `include_metrics` _boolean_ — Include a metrics summary per project. Defaults to false.
  - `metrics_time_range` _string_ — Metrics window when include_metrics is true: 1h, 24h, 7d, or 30d. Defaults to 24h.



  ### Request example


```bash
curl "https://api.agnt5.com/api/v1/projects?page_size=10" \
  -H "X-API-KEY: {api_key}"
```

```javascript
fetch('https://api.agnt5.com/api/v1/projects?page_size=10', {
  headers: { 'X-API-KEY': apiKey }
})
```


  ```json {{ title: 'Response' }}
  {
    "success": true,
    "message": "Projects retrieved successfully",
    "data": [
      {
        "id": "b6f1a3e2-9c4d-4f7a-8e2b-1a2b3c4d5e6f",
        "name": "invoice-processor",
        "ref": "invoice-processor-a1b2",
        "slug": "invoice-processor",
        "status": "active",
        "language": "python",
        "language_version": "3.12",
        "workflows_count": 4,
        "deployments_count": 6,
        "created": 1732636800000,
        "updated": 1753612800000,
        "environment": "production",
        "created_by": "3f2b1a0c-...",
        "created_by_email": "dev@example.com",
        "prod_deployment_id": "8a1c2d3e-...",
        "prod_deployment_at": 1753612800000,
        "organization_id": "1a2b3c4d-...",
        "infra_type": "managed"
      }
    ],
    "metadata": {
      "count": 1,
      "page": 1,
      "hasNext": false,
      "hasPrev": false,
      "unfilteredCount": 1,
      "hasAny": true
    }
  }
  ```