Beautiful Open-Source Form Builder
---
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 |
| per_page | number | Number of forms per page (minimum 1, maximum 100). | 10 |
## 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.