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

# List Projects

> Returns a paginated list of projects in the authenticated organization.

## Query parameters

<ParamField query="limit" type="number">
  Page size. 1–100, default 50.
</ParamField>

<ParamField query="cursor" type="number">
  Timestamp cursor from a previous response's `nextCursor`.
</ParamField>

<ParamField query="slug" type="string">
  Optional exact slug filter. When provided, results are constrained to at most one project.
</ParamField>

When `slug` is present:

* `cursor` is not allowed (`422 VALIDATION_ERROR`)
* `limit` is ignored and internally forced to 1

## Response

<ResponseField name="items" type="Project[]" required />

<ResponseField name="nextCursor" type="number | null" required />

<ResponseField name="hasMore" type="boolean" required />

<RequestExample>
  ```bash theme={null}
  curl https://nest.feather.mupeni.dev/v1/projects \
    -H "Authorization: Bearer <server_key>"

  curl "https://nest.feather.mupeni.dev/v1/projects?slug=my-app" \
   -H "Authorization: Bearer <server_key>"

  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "proj_01hx...",
        "orgId": "org_01hx...",
        "name": "My App",
        "slug": "my-app",
        "createdAt": "2024-03-01T12:00:00.000Z"
      }
    ],
    "nextCursor": null,
    "hasMore": false
  }
  ```
</ResponseExample>