GET
/
v1
/
api
/
forms
/
{formId}
/
submissions
/
{submissionId}
{
  "submission": {
    "questions": [
      {
        "id": "abcdef",
        "name": "What's your name?",
        "type": "ShortAnswer",
        "value": "Timmy"
      }
    ],
    "calculations": [
      {
        "id": "calculation1",
        "name": "price",
        "type": "number",
        "value": "12.50"
      }
    ],
    "urlParameters": [
      {
        "id": "email",
        "name": "email",
        "value": "example@example.com"
      }
    ],
    // If form is configued to be a quiz
    "quiz": {
      "score": 5,
      "maxScore": 10
    },
    "submissionId": "abc",
    "submissionTime": "2024-05-16T23:20:05.324Z",
    // If using Fillout Scheduling
    "scheduling": [
      {
        "id": "nLJtxBJgPA",
        "name": "30 min meeting",
        "value": {
          "fullName": "John Smith",
          "email": "john@smith.com",
          "timezone": "Europe/London",
          "eventStartTime": "2024-05-20T09:00:00.000Z",
          "eventEndTime": "2024-05-20T09:30:00.000Z",
          "eventId": "du5ckkaeacd5dlj16d7ajepp8g",
          "eventUrl": "https://www.google.com/calendar/event?eid=ZHU1Y2trYWVhY2Q1ZGxqMTZkN2FqZXBwOGcgYXJjaGllQGZpbGxvdXQuY29t&authuser=john%40smith.com"
        }
      }
    ]
  }
}

​
Request

​
URL parameters

​
formId
string
required

The public identifier of the form for which you want to retrieve submissions. This should be a string. If your form’s URL is https://form.fillout.com/t/gHretr3UKYus, the form ID is gHretr3UKYus

​
submissionId
string
required

The identifier of the submission

​
Query parameters

​
includeEditLink
boolean

Pass true to include a link to edit the submission as editLink

{
  "submission": {
    "questions": [
      {
        "id": "abcdef",
        "name": "What's your name?",
        "type": "ShortAnswer",
        "value": "Timmy"
      }
    ],
    "calculations": [
      {
        "id": "calculation1",
        "name": "price",
        "type": "number",
        "value": "12.50"
      }
    ],
    "urlParameters": [
      {
        "id": "email",
        "name": "email",
        "value": "example@example.com"
      }
    ],
    // If form is configued to be a quiz
    "quiz": {
      "score": 5,
      "maxScore": 10
    },
    "submissionId": "abc",
    "submissionTime": "2024-05-16T23:20:05.324Z",
    // If using Fillout Scheduling
    "scheduling": [
      {
        "id": "nLJtxBJgPA",
        "name": "30 min meeting",
        "value": {
          "fullName": "John Smith",
          "email": "john@smith.com",
          "timezone": "Europe/London",
          "eventStartTime": "2024-05-20T09:00:00.000Z",
          "eventEndTime": "2024-05-20T09:30:00.000Z",
          "eventId": "du5ckkaeacd5dlj16d7ajepp8g",
          "eventUrl": "https://www.google.com/calendar/event?eid=ZHU1Y2trYWVhY2Q1ZGxqMTZkN2FqZXBwOGcgYXJjaGllQGZpbGxvdXQuY29t&authuser=john%40smith.com"
        }
      }
    ]
  }
}