# TIGER FORM Public API — Changelog (v1)

Documented changes to the **public HTTP API** (`public.openapi.json`) are listed here after each public release.

---

## [1.0.0] — 2026-06-15

**Initial public release** of the TIGER FORM HTTP API v1, OpenAPI specification, and integrator documentation.

- **Base URL:** `https://api.form-qr-code-generator.com/v1`
- **Documentation:** `https://docs.form-qr-code-generator.com/v1/`
- **Authentication:** `Authorization: Bearer <API_KEY>` on every documented route. A **monthly API request limit** applies per plan tier (see Rate Limits in the integrator guide; enforced server-side as `apiLimit`).

### Included in v1.0.0

- **Forms** — create, read, update, delete, archive/restore, clone, share, QR image download.
- **Submissions** — create with simplified **`answers`** map, optional validate, read/update/delete, batch delete; **`GET /forms/{qrId}/submission-schema`** for field keys and value types; optional **`Idempotency-Key`** on create.
- **Field types** — all supported form field types (text, choice, address, checklist, sheet, file uploads, signature, media, etc.) via the public form and submission contract.
- **Uploads** — account logo (`POST /account/uploads`); form assets and submission files (`POST /forms/{qrId}/uploads` with `category=form` or `submission`).
- **Webhooks** — account-level `submission.created` delivery with signing secret (`GET` / `PUT /account/webhook`).
- **Form analytics** — scan/submission analytics and optional CSV export (`GET /forms/{qrId}/analytics`).
- **Quiz forms** — scored question types (radio, checkbox, short text, number) with quiz result on submit.
- **Team API** — list/create/update/delete members (Business+ plans; Owner/Admin for management).
- **Optional:** form templates marketplace, AI form builder draft, QR design preset catalog.

### Plan API quota (monthly request limits)

| Plan | Monthly API requests |
|------|----------------------|
| Freemium | `500` |
| Starter | `10,000` |
| Business | `30,000` |
| Professional | `50,000` |
| Enterprise | [Contact us](https://www.form-qr-code-generator.com/contact-us) or `tiger-form@qrtiger.helpscoutapp.com` |

See [Rate Limits & Retries](https://docs.form-qr-code-generator.com/v1/index.htm#rate-limits) in the integrator guide.

**Inactive paid subscription:** Accounts are not downgraded to Freemium when a paid plan lapses. Most documented API operations return HTTP **400** until renewal. HTTP **429** applies when the monthly API request limit is exhausted.

### Integrator resources

- OpenAPI: `public.openapi.json` (also linked from the docs site)
- Postman: `postman.collection.json`
- Field samples: `schema-examples.json`

Breaking or notable changes to **documented** behavior after this release will be announced here at least **90 days** before removal, except urgent security fixes.

---

## Notes for integrators

- **Production base URL:** `https://api.form-qr-code-generator.com/v1`
- **Release policy and version history:** [Versioning guide](https://docs.form-qr-code-generator.com/v1/index.htm#versioning) (preferred) or this file.
- There is no separate sandbox URL — use a dedicated test account and test forms on production with non-production data.