Form Submission entity
Read submitted form records with the source form, backup JSON, and nested submitted field values.
#Endpoints
Form submissions are customer-submitted records for dealership forms. Submitted field values are nested with their form field metadata.
GET/v1/form-submissions
GET/v1/form-submissions/{id}
x-api-key header.#Filters and Limits
List endpoints share the same pagination envelope. Query booleans use true or false.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | No | Number of records to return. Defaults to 100. Maximum is 500. |
| offset | number | No | Number of records to skip. Defaults to 0. |
| search | string | No | Optional text search. Searchable fields are listed on each entity. |
| createdAfter | datetime | No | Return records created at or after an ISO 8601 timestamp. |
| createdBefore | datetime | No | Return records created at or before an ISO 8601 timestamp. |
| updatedAfter | datetime | No | Return records updated at or after an ISO 8601 timestamp. |
| updatedBefore | datetime | No | Return records updated at or before an ISO 8601 timestamp. |
| formId | uuid | No | Filter by source form ID. |
formId and search.name and service.createdAt descending, then id descending.JSON
{
"data": [],
"pagination": {
"limit": 100,
"offset": 0,
"total": 0
}
}#Response
| Field | Type | Nullable | Notes |
|---|---|---|---|
| id | uuid | No | Form submission ID. |
| form | FormSummary | No | Source form summary. |
| backup | json | Yes | Backup submission payload. |
| fields | FormSubmissionField[] | No | Submitted field values with field metadata. |
| createdAt | datetime | No | Creation timestamp. |
| updatedAt | datetime | No | Last update timestamp. |
#Example Request
Shell
curl "https://api.driverseat.io/v1/form-submissions?formId=form-id" \
-H "x-api-key: sk-driverseat-..."