---
title: "List Workspace Forms"
method: GET
path: "/open/workspaces/{workspaceId}/forms"
tags: ["Forms"]
---

# List Workspace Forms

`GET /open/workspaces/{workspaceId}/forms`

Retrieve all forms within a specific workspace. Returns lightweight form summaries (excludes `properties`). Use the Get Form endpoint to retrieve the full form with all fields. Requires `forms-read` ability.

## Path parameters

- `workspaceId` number, required — ID of the workspace to retrieve forms from.

## Query parameters

- `page` number

## Response `200`

Successful

- object
  - `data` FormListItem[]
    - `id` number — The unique identifier for the form.
    - `slug` string — The URL-friendly slug for the form.
    - `title` string — The title of the form.
    - `visibility` 'public' | 'draft' | 'closed' — The current visibility state of the form.
    - `tags` string[], nullable
    - `views_count` number — Total number of form views.
    - `submissions_count` number — Total number of completed submissions.
    - `created_at` string, date-time — ISO 8601 timestamp of when the form was created.
    - `updated_at` string, date-time — ISO 8601 timestamp of when the form was last modified.
    - `last_edited_human` string — Human-readable time since last edit (e.g., "2 hours ago").
    - `closes_at` string, date-time, nullable — When the form will close for submissions.
    - `is_closed` boolean — Whether the form is currently closed.
    - `max_submissions_count` integer, nullable — Maximum number of submissions allowed.
    - `max_number_of_submissions_reached` boolean — Whether the submission limit has been reached.
    - `is_pro` boolean — Whether the form's workspace has a Pro subscription.
    - `workspace_id` number — ID of the workspace that owns the form.
    - `share_url` string, uri — Public URL to share the form.
  - `links` object
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` object
    - `current_page` number
    - `from` number
    - `last_page` number
    - `per_page` number
    - `to` number
    - `total` number

## Other responses

- `403` — Forbidden – token lacks forms-read ability or you do not have access to the workspace
- `404` — Workspace not found

---

[API](https://skmtc.dev/opnform/apis/opnform-api.md) · [All operations](https://skmtc.dev/opnform/apis/opnform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opnform/opnform-api/revisions/271b61a0082b/schema)