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

> List bounties across all projects with filtering.

Public endpoint — no authentication required.

## Query parameters

<ParamField query="status" type="string">
  Filter by status: `open`, `claimed`, `in_review`, or `done`.
</ParamField>

<ParamField query="project_id" type="string">
  Filter by project ID.
</ParamField>

<ParamField query="difficulty" type="string">
  Filter by difficulty: `easy`, `medium`, `hard`, or `extreme`.
</ParamField>

<ParamField query="search" type="string">
  Search by keyword in title 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/bounties?status=open&difficulty=easy&limit=10"
```

## Response

```json 200 theme={null}
{
  "bounties": [
    {
      "id": "bnt_x1y2z3",
      "project_id": "proj_m1n2o3",
      "title": "Add CSV export endpoint",
      "description": "Add a GET /export endpoint...",
      "reward_amount": 500,
      "difficulty": "easy",
      "status": "open",
      "created_at": "2026-03-29T15:00:00.000Z"
    }
  ]
}
```