---
title: "List a form's fields"
method: GET
path: "/v1/forms/{form_id}/fields"
tags: ["forms"]
---

# List a form's fields

`GET /v1/forms/{form_id}/fields`

## Request

- Base URL: `https://api.formcarry.com`
- URL: `https://api.formcarry.com/v1/forms/{form_id}/fields`
- Auth: HTTP bearer

Returns the field names carried by the newest 2,000 submissions of this form, sorted by most used first. Each field returns with how many of them carry it and when the newest one arrived. Only the first 200 names are shown.

Use the counts to tell a name the form still collects from one that was renamed. For example, a name on 11 of 2,000 submissions that was last seen in March is probably a renamed or outdated field, and not the one to filter on.

## Path parameters

- `form_id` string, required

## Response `200`

- FormFields
  - `data` FormFieldUsage[], required: Most used first, at most 200 names.
    - `name` string, required
    - `count` number, required: How many of the submissions read carry this field
    - `last_seen` string, nullable, required: When the newest submission carrying it arrived
  - `submissions_read` number, required: How many submissions were read, newest first. Max 2,000.

## Other responses

- `401`: The request carried no usable key or token.
- `403`: The key is valid but may not do this.
- `429`: Slow down and retry after the Retry-After header.

---

[API](https://skmtc.dev/formcarry/apis/formcarry-api.md) · [All operations](https://skmtc.dev/formcarry/apis/formcarry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formcarry/apis/formcarry-api/revisions/c971f37d5987?raw)