Paginated submissions for one form (org-scoped).
since / until (ISO-8601, inclusive / exclusive) bound created_at. format=flat returns answers as {label: value}. include=mapping_results keeps the full per-mapping outcome list; when either flag is given and it is not, each row carries a mapping_summary {ok, failed} instead. With neither flag the historical shape is returned unchanged.
URL
- User APIhttps://forms.mattering.io/api/user/v1/forms/{short_code}/submissions/
- Service tierhttps://forms.mattering.io/api/internal/forms/{short_code}/submissions/
Path parameters
| Name | Type |
|---|---|
short_code | str |
Query parameters
| Name | Default |
|---|---|
format | none |
include | none |
Pagination
Accepts limit and offset. The response meta carries total, limit and offset.
Responses
200 bare JSON object (no envelope)
{
"submissions": [
{
"id": "...",
"created_at": "2026-01-01T00:00:00Z",
"answers": "...",
"mapping_results": "...",
"mapping_summary": "..."
}
],
"meta": {
"...": "..."
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | invalid_field |
| 401 | unauthorized |
| 404 | not_found |
Example
curl -X GET "https://forms.mattering.io/api/user/v1/forms/SHORT_CODE/submissions/?format=...&include=..." \ -H "Authorization: Bearer $MATTERING_API_KEY"
curl -X GET "https://forms.mattering.io/api/internal/forms/SHORT_CODE/submissions/?format=...&include=..." \ -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \ -H "X-Internal-Org-Id: $ORG_ID" \ -H "X-Internal-User-Email: you@example.com"
Source: FormsCore/internal_api.py (internal_api.form_submissions)