---
title: "Get form by ID"
method: GET
path: "/forms/{formId}"
tags: ["Forms"]
---

# Get form by ID

`GET /forms/{formId}`

Retrieves a form's complete definition. Requires VIEW permission or higher.

## Response `200`

Form details.

- Form
  - `id` string, ulid, required
  - `owner` string, ulid, required
  - `title` string, required
  - `slug` string, required
  - `description` string, nullable
  - `structure` string, kdl, required
  - `live` boolean, required
  - `opens` string, date-time, nullable
  - `closes` string, date-time, nullable
  - `anonymous` boolean
  - `max_responses` integer, nullable
  - `individual_limit` integer
  - `editable_responses` boolean

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2025-07-14** `3fcd68b489c2` — 4 info
  - added the optional property `anonymous` to the response with the `200` status
  - the `editable_responses` response's property default value `false` was added for the status `200`
  - the `individual_limit` response's property default value `1` was added for the status `200`
  - the `live` response's property default value `false` was added for the status `200`
- **2025-07-13** `434dd7ec37b5` — 1 breaking, 1 info
  - removed the required property `specification` from the response with the `200` status
  - added the required property `structure` to the response with the `200` status
- **2025-07-13** `0d7f3c750979` — 1 breaking, 1 warning, 4 info
  - removed the required property `structure` from the response with the `200` status
  - removed the optional property `anonymous` from the response with the `200` status
  - the `editable_responses` response's property default value `false` was removed for the status `200`
  - the `individual_limit` response's property default value `1` was removed for the status `200`
  - …2 more

[Change history](https://skmtc.dev/osdg-iiith/apis/forms-portal-api/changes/forms/:formId/get.md)

---

[API](https://skmtc.dev/osdg-iiith/apis/forms-portal-api.md) · [All operations](https://skmtc.dev/osdg-iiith/apis/forms-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/osdg-iiith/forms-portal-api/revisions/85c657c8ce11/schema)