---
title: "GET /forms/{slug_or_id}/fields"
method: GET
path: "/forms/{slug_or_id}/fields"
tags: ["Form Fields"]
---

# GET /forms/{slug_or_id}/fields

`GET /forms/{slug_or_id}/fields`

This endpoint returns the list of fields available for a specific form by slug or ID. This feature is available as part of the [Standard API](https://paperform.co/pricing/).

## Path parameters

- `slug_or_id` string, required

## Query parameters

- `search` string

## Response `200`

Successfully returned fields for a single form that matched the provided slug or ID

- object
  - `status` 'ok'
  - `results` object
    - `fields` FormFieldCollectionItem[]
      - `key` string — The unique key for this field.
      - `title` string, nullable — The title of this field.
      - `description` string, nullable — The description of this field.
      - `required` boolean, nullable — Whether this field is required.
      - `custom_key` string, nullable — The custom key of this field.
      - `placeholder` string, nullable — The placeholder for this field.
      - `type` 'text' | 'email' | 'url' | 'yesNo' | 'color' | 'number' | 'phone' | 'address' | 'country' | 'appointment' | 'date' | 'time' | 'scale' | 'slider' | 'choices' | 'dropdown' | 'image' | 'file' | 'signature' | 'price' | 'products' | 'subscriptions' | 'calculations' | 'hidden' | 'rank' | 'rating' | 'matrix' — The type of field.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Not Permitted
- `404` — Not Found
- `429` — Too Many Requests
- `5XX` — Unexpected Error

---

[API](https://skmtc.net/paperform/apis/paperform-api.md) · [All operations](https://skmtc.net/paperform/apis/paperform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paperform/paperform-api/versions/dc1e62b7063d/schema)