---
title: "GET /forms/{slug_or_id}/submissions"
method: GET
path: "/forms/{slug_or_id}/submissions"
tags: ["Submissions"]
---

# GET /forms/{slug_or_id}/submissions

`GET /forms/{slug_or_id}/submissions`

This endpoint returns a list of submissions for a form matching the requested parameters. This feature is available as part of the [Standard API](https://paperform.co/pricing/).

## Path parameters

- `slug_or_id` string, required

## Query parameters

- `limit` integer
- `skip` integer
- `after_id` string
- `before_id` string
- `before_date` string, date-time
- `after_date` string, date-time
- `sort` 'ASC' | 'DESC'

## Response `200`

Successfully returned a list of submissions

- object
  - `status` 'ok'
  - `results` object
    - `submissions` Submission[]
      - `id` string, uuid — The unique identifier of the Submission.
      - `form_id` string, uuid — The id of the Form for the Submission.
      - `data` SubmissionData — The `data` object stores the answers from the form. Each value is stored against it's key. Note that custom keys are not used here.
        - `KEY` union
          - string
          - number
          - union[]
            - union
              - …
          - object
          - boolean
      - `device` Device — Information about the device which made the submission.
        - `type` string
        - `device` string
        - `platform` string
        - `browser` string
        - `embedded` boolean
        - `url` string, uri
        - `user_agent` string
        - `utm_source` string
        - `utm_medium` string
        - `utm_campaign` string
        - `utm_term` string
        - `utm_content` string
        - `ip_address` string
      - `charge` Charge — Information about payments relating to the submission.
        - `products` object — The products included in the charge.
        - `summary` string — A summary of the charge.
        - `discount` integer — The total discount applied to the charge.
        - `discounted_subscriptions` string[] — The IDs of discounted subscriptions in the charge.
        - `coupon` boolean — If a coupon was applied to the charge.
        - `total` integer — The total of the charge.
        - `tax` integer — The fixed tax amounts on the charge.
        - `tax_percentage` integer — The percentage tax amounts on the charge.
        - `processing_fee` integer — The processing fee on the charge.
        - `authorize` boolean — If the charge was only authorized for later capture.
        - `receipt_email` string, email, nullable — The receipt email given in the checkout.
        - `customer` Customer — The customer attached to the charge.
          - `id` string, uuid
        - `charge` string
        - `payment_source_id` integer — The id of the payment source used to make the charge.
        - `payment_source_service` string — The payment service from the payment source used to make the charge.
        - `live` boolean — If the charge was made in 'live' mode.
      - `pdfs` object, nullable — The PDFs generated for the Submission.
      - `created_at` string — A formatted date-time string in your account timezone indicating the time the form was created.
      - `account_timezone` string — The configured timezone for your account.
      - `created_at_utc` string, date-time — A formatted date-time string in UTC indicating the time the form was created.
  - `total` integer — The total number of items.
  - `has_more` boolean — Whether there are more items.
  - `limit` integer — The limit of items per page.
  - `skip` integer — The number of items to skip.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Not Permitted
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `5XX` — Unexpected Error

---

[API](https://skmtc.dev/paperform/apis/paperform-api.md) · [All operations](https://skmtc.dev/paperform/apis/paperform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paperform/paperform-api/revisions/dc1e62b7063d/schema)