Skip to main content
GET
/
forms
/
{form_id}
/
submissions
List submissions
curl --request GET \
  --url https://app.oneform.one/api/v1/forms/{form_id}/submissions \
  --header 'Authorization: Bearer <token>'
{
  "questions": [
    {
      "id": "q_123",
      "name": "What is your name?",
      "type": "SHORT_ANSWER",
      "is_deleted": false
    }
  ],
  "submissions": [
    {
      "id": "sub_123",
      "created_at": "2024-01-01T12:00:00Z",
      "is_partial": false,
      "responses": {
        "q_1": "Answer 1",
        "q_2": "Answer 2"
      }
    }
  ],
  "page": 1,
  "limit": 25,
  "total": 100,
  "has_next": true
}

Authorizations

Authorization
string
header
required

Enter your API key

Path Parameters

form_id
string
required

Form ID

Query Parameters

page
integer

Page number (default: 1)

limit
integer
default:25

Items per page (default: 25)

Required range: 1 <= x <= 50
filter
enum<string>
default:completed

Filter type (completed, partial, all)

Available options:
completed,
partial,
all

Response

successful

questions
object[]

Array of question objects for the form

submissions
object[]

Array of submission objects

page
integer

Current page number

Example:

1

limit
integer

Number of items per page

Example:

25

total
integer

Total number of submissions

Example:

100

has_next
boolean

Whether there are more pages available

Example:

true