Menu

Submissions

1 endpoint in the Mattering Forms API.

GET forms/{short_code}/submissions/ User APIService tier

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

NameType
short_codestr

Query parameters

NameDefault
formatnone
includenone

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

StatusCode
400invalid_field
401unauthorized
404not_found

Example

curl -X GET "https://forms.mattering.io/api/user/v1/forms/SHORT_CODE/submissions/?format=...&include=..." \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: FormsCore/internal_api.py (internal_api.form_submissions)

All Forms resources
Start Free Explore our Products