Skip to the documentation
API

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

Runs the real call on your workspace.

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.

Your inbox,
on your own terms.

Email infrastructure for businesses, AI, agents and personal email. Built for scale, privacy and control. Everything email should have had from day one.

© 2026 OpenEmail. All rights reserved.