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

# List projects

> Page through your projects, newest first.

Returns a page of your projects, newest first.

## Query parameters

**status** `string`

Filter by status.

**limit** `integer` (default: 50)

Projects per page. Maximum 200.

**cursor** `string`

`nextCursor` from the previous page.

## Response

**projects** `object[]` *required*

Same object as [Get a project](https://docs.emporiaresearch.com/demand-api/get-project.md).

**nextCursor** `string | null` *required*

Pass as `cursor` to get the next page. `null` on the last page.

## Errors

General errors are listed in the [Overview](https://docs.emporiaresearch.com/demand-api/overview.md#errors).

| Status | Code | When |
| - | - | - |
| 400 | `INVALID_STATUS` | `status` isn't valid. |

```http Request theme={null}
GET /v1/projects?status=ACTIVE&limit=50
Authorization: Bearer <api_key>
```

```json 200 theme={null}
{
  "projects": [
    {
      "id": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b",
      "name": "Q4 IT security buyer interviews",
      "status": "ACTIVE",
      "audience": "CYBERSECURITY_PROFESSIONALS",
      "studyType": "AI_MODERATED_INTERVIEW",
      "targetNSize": 20,
      "completes": 8
    }
  ],
  "nextCursor": "4f1a9c2e7b3d4a8e9c6b2d5f8a1e3c7b"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.