---
openapi: get /open/workspaces/{workspaceId}/forms
---

Retrieve all forms within a specific workspace.

<Info>
This endpoint returns **lightweight form summaries** optimized for listing. The `properties` array (form fields and blocks) is excluded to reduce response size. Use the [Get Form](./get-form) endpoint to retrieve the complete form with all fields.
</Info>

## Authentication & Scope

This request must be authenticated using a **Personal Access Token** that includes the `forms-read` ability.

```http
Authorization: Bearer <token>
```

## Request

```http
GET /open/workspaces/{workspaceId}/forms HTTP/1.1
Host: api.opnform.com
Authorization: Bearer <token>
```

### Path Parameters

| Parameter   | Type   | Description                      |
|-------------|--------|----------------------------------|
| workspaceId | number | ID of the workspace to retrieve forms from. |

### Query Parameters

| Parameter | Type   | Description                                    | Default |
|-----------|--------|------------------------------------------------|---------|
| page      | number | Page number for pagination.                    | 1       |

## Response

`200 OK` – Returns a paginated JSON response containing lightweight form summaries.

```json
{
  "data": [
    {
      "id": 42,
      "slug": "customer-feedback",
      "title": "Customer Feedback",
      "visibility": "public",
      "tags": ["feedback", "support"],
      "views_count": 1250,
      "submissions_count": 15,
      "created_at": "2024-11-15T10:30:00+00:00",
      "updated_at": "2025-01-02T14:25:00+00:00",
      "last_edited_human": "2 hours ago",
      "closes_at": null,
      "is_closed": false,
      "max_submissions_count": null,
      "max_number_of_submissions_reached": false,
      "is_pro": true,
      "workspace_id": 1,
      "share_url": "https://opnform.com/forms/customer-feedback"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 10,
    "total": 1
  }
}
```

<Tip>
To get the full form including fields (`properties`), call the [Get Form](./get-form) endpoint with the form's `slug` or `id`.
</Tip>

`403 Forbidden` – The token does not include the required `forms-read` ability, or you do not have access to the workspace.

`404 Not Found` – The workspace does not exist.

