GET
/
v1
/
api
/
forms
/
{formId}
/
submissions
{
	"responses": [
		{
			"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"
				}
			],
			// optional depending on if form is configured 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",
						"rescheduleOrCancelUrl": "https://schedule.fillout.com/event/3EhDXDtvEtus?t=Cq52ZAGUnDpnnlatjDKD1yjtGCFNGajY"
					}
				}
			],
			// If using Fillout Payments
			"payments": [
				{
					"id": "cLJtxCKgdL",
					"name": "Complete checkout",
					"value": {
						"stripeCustomerId": "cus_Ppjz3Z80000000",
						"stripeCustomerUrl": "https://dashboard.stripe.com/customers/cus_Ppjz3Z80000000",
						"stripePaymentUrl": "https://dashboard.stripe.com/payments/pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						"totalAmount": 1000,
						"currency": "USD",
						"email": "john@doe.com",
						"discountCode": "10OFF",
						"status": "succeeded",
						"paymentId": "pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						"stripeSubscriptionId": "sub_Ppjz3Z80000000"
					}
				}
			],
			// If using a login pag
			"login": {
          "email": "verified@email.com"
      }
		}
	],
	"totalResponses": 300, // total number of submissions matching given parameters
	"pageCount": 2 // total number of pages of submissions based on provided limit
}

​
Request

​
URL parameters

​
formId
string
required

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

​
Query parameters

​
limit
number
default:"50"

The maximum number of submissions to retrieve per request. Must be between 1 and 150.

​
afterDate
string

A date string to filter submissions submitted after this date

​
beforeDate
string

A date string to filter submissions submitted before this date

​
offset
number

The starting position from which to fetch the submissions. Default is 0.

​
status
string

Pass in_progress to get a list of in-progress (unfinished) submissions. By default, only finished submissions are returned. Note that fetching in progress submissions is available starting on the business plan.

​
includeEditLink
boolean

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

​
includePreview
boolean

Pass true to include preview responses

​
sort
string

Can be asc or desc. Defaults to asc

​
search
string

Filter for submissions containing a string of text

Date format

Both afterDate and beforeDate parameters should be provided in the following format: YYYY-MM-DDTHH:mm:ss.sssZ. For example: 2024-05-16T23:20:05.324Z.

{
	"responses": [
		{
			"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"
				}
			],
			// optional depending on if form is configured 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",
						"rescheduleOrCancelUrl": "https://schedule.fillout.com/event/3EhDXDtvEtus?t=Cq52ZAGUnDpnnlatjDKD1yjtGCFNGajY"
					}
				}
			],
			// If using Fillout Payments
			"payments": [
				{
					"id": "cLJtxCKgdL",
					"name": "Complete checkout",
					"value": {
						"stripeCustomerId": "cus_Ppjz3Z80000000",
						"stripeCustomerUrl": "https://dashboard.stripe.com/customers/cus_Ppjz3Z80000000",
						"stripePaymentUrl": "https://dashboard.stripe.com/payments/pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						"totalAmount": 1000,
						"currency": "USD",
						"email": "john@doe.com",
						"discountCode": "10OFF",
						"status": "succeeded",
						"paymentId": "pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						"stripeSubscriptionId": "sub_Ppjz3Z80000000"
					}
				}
			],
			// If using a login pag
			"login": {
          "email": "verified@email.com"
      }
		}
	],
	"totalResponses": 300, // total number of submissions matching given parameters
	"pageCount": 2 // total number of pages of submissions based on provided limit
}

The question’s type will be a question type listed in the previous section (such as EmailInput), while the type for a calculation is either number or text

New field types are added regularly. Your application should discard fields with unknown types.