Changelog

All notable changes to the forms.app API and this documentation site are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Initial API release — Read-only programmatic access to your forms and submissions at https://api.forms.app.
• Authentication — Support for API keys (X-Api-Key header) and OAuth 2.0 bearer tokens. Exactly one method is required per request.
• Form endpoints
  • GET /v1/form — List all forms in your account
  • GET /v1/form/{id} — Retrieve a form's complete structure (questions, design, settings, thank-you pages)
• Submission endpoints
  • GET /v1/form/{id}/answer/p/{pageNumber} — Page through submitted answers with totalCount and searchAfter cursors
• Gateway
  • GET /__health — Health check endpoint (no authentication required)
• Response envelope — Consistent JSON structure with success, data, and errors fields across all endpoints
• Rate limiting — Per-key and per-token limits with 429 Too Many Requests responses
• Documentation site
  • Quick start, The essentials, and FAQ
  • Tutorials for fetching forms and fetching submissions
  • Form schema reference covering all question types, settings, and customization options
  • OpenAPI reference

• The API is read-only. Creating, updating, or deleting forms and submissions through the API is not supported in this release.