---
title: "List accessible forms"
method: GET
path: "/forms"
---

# List accessible forms

`GET /forms`

## Request

- Base URL: `https://app.formasty.com/api/v1`
- URL: `https://app.formasty.com/api/v1/forms`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://app.formasty.com/oauth/authorize/api/v1`, token URL `https://app.formasty.com/oauth/token`)
  - HTTP bearer

Lists forms in one workspace granted to the credential. OAuth connections can select any authorized workspace; API keys remain bound to one workspace.

## Query parameters

- `limit` integer
- `cursor` string
- `workspaceId` string

## Headers

- `X-Formasty-Workspace-Id` string

## Response `200`

Forms list.

- FormListResponse
  - `data` FormSummary[], required
    - `id` string, required
    - `workspace_id` string, required
    - `title` string, required
    - `status` 'draft' | 'published', required
    - `draft_revision` integer, required
    - `published_draft_revision` integer, nullable, required: Draft revision currently represented by the published snapshot, or null for an unpublished or legacy snapshot.
    - `draft_updated_at` integer, required
    - `public_url` string, nullable, required
    - `public_id` string
    - `slug` string, nullable
    - `plan` string
    - `workspace_role` string
    - `permissions` object
    - `plan_access` object
    - `is_shared` boolean
    - `shared_member_count` integer
    - `responses_count` integer
    - `views_count` integer, nullable
    - `starts_count` integer, nullable
    - `completions_count` integer, nullable
    - `schema_version` integer
    - `published_version` integer
    - `published_at` string, nullable
    - `created_at` integer
    - `updated_at` integer
  - `next_cursor` string, nullable, required: Opaque continuation token. Pass it as cursor on the next request; null means the collection is exhausted.

## Other responses

- `default`: A machine-readable error with a stable code and a recovery hint. The legacy error value is retained for existing clients.

---

[API](https://skmtc.dev/formasty/apis/formasty-forms-api.md) · [All operations](https://skmtc.dev/formasty/apis/formasty-forms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formasty/apis/formasty-forms-api/revisions/09ad7f50c693?raw)