---
title: "List forms"
description: "Every sign-up form in the workspace, newest first, without the document or settings. `stats` is counted at the moment of the read."
url: "https://openemail.uk/docs/api/forms/list"
area: "API"
category: "Mailbox"
---

# List forms

Every sign-up form in the workspace, newest first, without the document or settings. `stats` is counted at the moment of the read.

`GET /forms`

## GET /forms

Every sign-up form in the workspace, newest first, without the document or settings. `stats` is counted at the moment of the read.

## Example

Needs `forms:read`. `limit` goes up to 100 and defaults to 25, and `cursor` takes the previous page's `nextCursor`.

**curl**

```
curl "$OE/forms" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "form",
      "id": "frm_3b9d2e7a1c4f80d56e2a9b14",
      "name": "Newsletter sign-up",
      "description": null,
      "status": "live",
      "url": "https://openemail.uk/form/frm_3b9d2e7a1c4f80d56e2a9b14",
      "subscribeUrl": "https://api.openemail.uk/subscribe/frm_3b9d2e7a1c4f80d56e2a9b14",
      "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],
      "doubleOptIn": true,
      "hasUnpublishedChanges": false,
      "stats": {
        "views": 1840,
        "submissions": 212,
        "added": 198,
        "pending": 14,
        "lastSubmittedAt": "2026-09-30T16:42:11.000Z"
      },
      "publishedAt": "2026-09-12T08:00:00.000Z",
      "createdAt": "2026-09-10T14:20:00.000Z",
      "updatedAt": "2026-09-12T08:00:00.000Z"
    }],
  "hasMore": false,
  "nextCursor": null
}
```

> An app a member connected lists only the forms that member made, as the app does for them.

> `stats.views` counts loads of the hosted page and the embed while the form was live. Views are not deduplicated by visitor.