# 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](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2026-06-24

### Added

- **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](/guides/quickstart), [The essentials](/guides/the-essentials), and [FAQ](/guides/faq)
  - Tutorials for [fetching forms](/guides/tutorials/fetching-forms) and [fetching submissions](/guides/tutorials/fetching-submissions)
  - [Form schema reference](/guides/form-schema/form-fields) covering all question types, settings, and customization options
  - [OpenAPI reference](/apis)


### Notes

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