List a form’s submissions

curl --request GET \
  --url https://{host}/api/v1/form-submission/list \
  --header 'Authorization: <api-key>'

import { createSiteClient } from '@fetchski/attract-cms-sdk';

const site = createSiteClient();
const formSubmissionPage = await site.formSubmissions().listFormSubmissions({ formId: 'clx8m2k4p0000a1b2c3d4e5f6' });

use Fetchski\AttractCmsLaravel\Facades\Attract;

$formSubmissionPage = Attract::formSubmissions()->listFormSubmissions(formId: 'clx8m2k4p0000a1b2c3d4e5f6');

{
  "submissions": [
    {
      "_id": "66f1c2a9e4b0a1b2c3d4e5f7",
      "createdAt": "2026-10-01T14:05:10.000Z",
      "visitorId": "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b",
      "conversionEvents": [
        {
          "eventId": "9b1d4c2e-7f3a-4b5c-8d6e-0a1b2c3d4e5f",
          "conversionId": "clx8k2m0a0009abcd1234efgh",
          "title": "Contact form sent"
        }
      ],
      "data": {
        "name": "Sam Rivera",
        "email": "sam@example.com",
        "message": "Do you offer weekend hours?"
      }
    }
  ],
  "columns": [
    {
      "key": "<string>",
      "label": "<string>",
      "choices": {}
    }
  ],
  "total": 123,
  "page": 123,
  "perPage": 123,
  "totalPages": 2
}

{
  "name": "invalid",
  "message": "Send the Markdown as `markdown` (a string).",
  "data": {}
}

{
  "name": "invalid",
  "message": "The API key is not valid.",
  "data": {}
}

{
  "name": "forbidden",
  "message": "This API key lacks the required scope: forms:read.",
  "data": {}
}

{
  "name": "notfound",
  "message": "Not found.",
  "data": {}
}

{
  "name": "tooManyRequests",
  "message": "This API key’s rate limit is used up for this minute.",
  "data": {}
}