---
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
      - `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

---

[API](https://skmtc.net/craft/apis/craft-io-public-api.md) · [All operations](https://skmtc.net/craft/apis/craft-io-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craft/craft-io-public-api/revisions/df0d980eb1e3/schema)