> 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
---

<ApiEndpoint
  method="GET"
  endpoint="/api/v1/projects"
  description="List the projects visible to the authenticated user, across every workspace they belong to."
>
  <section>
    ### Query parameters

    <ApiAttribute name="page" type="integer" description="Page number. Defaults to 1." required={false} />
    <ApiAttribute name="page_size" type="integer" description="Results per page, 1-100. Defaults to 20." required={false} />
    <ApiAttribute name="search" type="string" description="Filter by project name (substring match)." required={false} />
    <ApiAttribute name="order_by" type="string" description="Field to sort by. Defaults to updated." required={false} />
    <ApiAttribute name="order_dir" type="string" description="asc or desc. Defaults to desc." required={false} />
    <ApiAttribute name="language" type="string" description="Filter by primary language, e.g. python or typescript." required={false} />
    <ApiAttribute name="status" type="string" description="Filter by project status." required={false} />
    <ApiAttribute name="workspace_id" type="string" description="Restrict results to a single workspace." required={false} />
    <ApiAttribute name="include_metrics" type="boolean" description="Include a metrics summary per project. Defaults to false." required={false} />
    <ApiAttribute name="metrics_time_range" type="string" description="Metrics window when include_metrics is true: 1h, 24h, 7d, or 30d. Defaults to 24h." required={false} />
  </section>

  <section>
    ### Request example

    <MultiLanguageCodeBlock
      languages={["bash", "javascript"]}
      value={[
        {
          language: 'bash',
          code: `curl "https://api.agnt5.com/api/v1/projects?page_size=10" \\
  -H "X-API-KEY: {api_key}"`
        },
        {
          language: 'javascript',
          code: `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
      }
    }
    ```
  </section>
</ApiEndpoint>