---
title: "List recent form submissions"
method: GET
path: "/api/v1/form-submissions"
tags: ["Form submissions (v1, deprecated)"]
deprecated: true
---

# List recent form submissions

`GET /api/v1/form-submissions`

## Request

- Base URL: `https://app.formaportal.com`
- URL: `https://app.formaportal.com/api/v1/form-submissions`
- Auth: OAuth 2 (authorization code, authorization URL `https://app.formaportal.com/oauth/authorize`, token URL `https://app.formaportal.com/api/oauth/token`, scopes: `submissions:read`)

> **Deprecated.**

The 25 most recent submissions for the token's portal, newest first. Intended for sample data and backfill; use a webhook for live events.

## Response `200`

Submissions, newest first.

- FormSubmission[]
  - `id` string, required
  - `submittedAt` string, date-time, required
  - `portalId` string, required
  - `formId` string, required
  - `formName` string, required
  - `formVersion` integer
  - `source` 'gate' | 'embed' | 'onboarding': Where the form was submitted from.
  - `status` 'pending' | 'approved' | 'rejected'
  - `contact` object, nullable
    - `id` string, required
    - `email` string, email, required
    - `firstName` string, required
    - `lastName` string, required
  - `accountId` string, nullable
  - `answers` object, required
  - `answersDetailed` object[]
    - `fieldId` string, required
    - `label` string, required
    - `type` string, required
    - `value` unknown, required

## Other responses

- `401`: Missing, invalid, expired or revoked token. The `WWW-Authenticate` header points at the protected-resource metadata.
- `403`: The token is valid but lacks a required scope. `WWW-Authenticate` names the scopes needed.

---

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