Prerequisites

  • A Tally account
  • An API key
  • An existing form with submissions

Request

To fetch submissions for a form, send a GET request to the /forms/:id/submissions endpoint:

curl -X GET 'https://api.tally.so/forms/:id/submissions' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json'

Response

The API will respond with a 200 status code and return an object containing the submissions and form metadata:

{
  "page": 1,
  "limit": 50,
  "hasMore": false,
  "totalNumberOfSubmissionsPerFilter": {
    "all": 4,
    "completed": 4,
    "partial": 0
  },
  "questions": [
    {
      "id": "EKOE2N",
      "type": "INPUT_TEXT",
      "title": "First name",
      "fields": [
        {
          "uuid": "21dd98ef-4c54-4e77-bcc6-7ec79409b3ea",
          "type": "INPUT_FIELD",
          "questionType": "INPUT_TEXT",
          "title": "First name"
        }
      ]
    }
  ],
  "submissions": [
    {
      "id": "GG6z5L",
      "formId": "mexJoq",
      "respondentId": "jzQdR9",
      "isCompleted": true,
      "submittedAt": "2024-12-30T09:02:01.000Z",
      "responses": [
        {
          "id": "4r5rAWb",
          "questionId": "EKOE2N",
          "answer": "Filip"
        }
      ]
    },
    {
      "id": "2WXeKV",
      "formId": "mexJoq",
      "respondentId": "kzQdR0",
      "isCompleted": true,
      "submittedAt": "2024-12-30T08:57:52.000Z",
      "responses": [
        {
          "id": "eR4RxeQ",
          "questionId": "EKOE2N",
          "answer": "Marie"
        }
      ]
    },
    {
      "id": "GPWkYL",
      "formId": "mexJoq",
      "respondentId": "lzQdR1",
      "isCompleted": true,
      "submittedAt": "2024-12-27T10:23:16.000Z",
      "responses": [
        {
          "id": "GlZqg8Q",
          "questionId": "EKOE2N",
          "answer": "Wouter"
        }
      ]
    },
    {
      "id": "MxBPJ8",
      "formId": "mexJoq",
      "respondentId": "mzQdR2",
      "isCompleted": true,
      "submittedAt": "2024-12-27T10:22:38.000Z",
      "responses": [
        {
          "id": "X0p8gDO",
          "questionId": "EKOE2N",
          "answer": "Frederik"
        }
      ]
    }
  ]
}