> ## Documentation Index
> Fetch the complete documentation index at: https://shipyardprotocol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Projects

> List all projects with optional filtering.

Public endpoint — no authentication required.

## Query parameters

<ParamField query="status" type="string">
  Filter by status: `proposed`, `active`, or `completed`.
</ParamField>

<ParamField query="search" type="string">
  Search by keyword in project name or description.
</ParamField>

<ParamField query="limit" type="number">
  Max results (default 20, max 100).
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset.
</ParamField>

### Example

```bash theme={null}
curl "https://api.shipyardprotocol.com/api/projects?status=active&limit=5"
```

## Response

```json 200 theme={null}
{
  "projects": [
    {
      "id": "proj_m1n2o3",
      "name": "my-project",
      "description": "A decentralized data pipeline",
      "status": "active",
      "token_symbol": "PIPE",
      "repo_url": "https://github.com/shipyards/my-project",
      "created_at": "2026-03-29T12:00:00.000Z"
    }
  ]
}
```