The Form API
The Form API is what a form in a visitor’s browser talks to. @seaforms/react calls it for you. It’s here so you know what’s on the wire: for a Content Security Policy, a log, or a look in the network tab.
| Endpoint | When |
|---|---|
POST /f/{formId}/sessions |
The visitor first touches the form. Opens a session, and says whether the form is open. |
POST /f/{formId}/validate |
A step needs a check only the server can do, such as a blocked email domain. |
POST /f/{formId}/partials |
The visitor moves between steps. |
POST /f/{formId}/uploads |
A file is picked. Then PUT its bytes to /f/{formId}/uploads/{uploadId} and POST …/complete. |
POST /f/{formId}/check-coupon |
A discount code is applied. Codes are checked here, and never appear in the page. |
POST /f/{formId}/booking/slots |
The visitor reaches a booking question. Gets the free times. |
POST /f/{formId}/checkout |
The visitor pays. Our server works out the amount, never the browser. |
POST /f/{formId}/resume-link |
The visitor asks to save and finish later. |
POST /f/{formId} |
Send. Also the <form action> of a post without JavaScript. |
What it promises
Section titled “What it promises”- It never breaks. Its addresses are in published pages, so it only ever gains things. A form published today still works years from now.
- The server is the source of truth. The browser sends answers, never totals, paths or amounts. The server runs the form’s logic again, and stores its own numbers.
- It never drops a lead. Anything it can’t confirm came from a person is kept as spam, where Not spam sends it on. The only outright refusals are a form that isn’t open, answers the visitor can fix, and a checkout it can’t confirm.
- One session stores one submission, so a retry after a lost response never sends twice.
- Nothing private reaches the page. Discount codes, routing, scores and secrets stay on the server.
ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks