---
title: "GET /feedback_portal/{portalId}/forms"
method: GET
path: "/feedback_portal/{portalId}/forms"
tags: ["Feedback Portals"]
---

# GET /feedback_portal/{portalId}/forms

`GET /feedback_portal/{portalId}/forms`

Get the list of your feedback portal's forms

## Path parameters

- `portalId` string, required

## Query parameters

- `categoryId` string
- `includeOptions` boolean

## Response `200`

A list of feedback portal forms and their metadata

- object
  - `forms` PortalForm[], required
    - `id` string, required
    - `name` string, required
    - `categories` Entity[], required
      - `id` string
      - `name` string, nullable
    - `fields` FormCustomField[], required
      - `id` string, required
      - `name` string, required
      - `type` string, required
      - `capacityEnabled` boolean — NUMBER fields only: true when the container plans capacity against this field. A capacity field (FE, BE) is otherwise indistinguishable from any other number (Reach, ACV) here. Read the limits with /capacity.
      - `categoryId` string, nullable
      - `categoryName` string, nullable
      - `values` string[]
      - `options` CustomFieldOption[]
        - `id` string, required
        - `label` string, required
        - `startDate` string, nullable
        - `endDate` string, nullable
      - `optionShape` 'select' | 'date' | 'date_range'
      - `multi` boolean
      - `source` 'portal' | 'workspace'
      - `required` boolean, required
  - `metadata` object, required
    - `count` number, double, required
    - `portalId` string, required

## Other responses

- `401` — No access to account
- `403` — Access denied
- `422` — Invalid portal ID
- `500` — An error occurred while fetching forms in a feedback portal

## Changes

- **2026-09-15** `9388f8d7ecd8` — 1 info
  - added the optional property `forms/items/fields/items/capacityEnabled` to the response with the `200` status

[Change history](https://skmtc.dev/craft/apis/craft-io-public-api/changes/feedback_portal/:portalId/forms/get.md)

---

[API](https://skmtc.dev/craft/apis/craft-io-public-api.md) · [All operations](https://skmtc.dev/craft/apis/craft-io-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craft/apis/craft-io-public-api/revisions/9388f8d7ecd8?raw)