---
title: "Paginated Submissions API Snippet"
slug: "paginated-submissions-api-snippet"
updated: 2025-09-26T07:07:43Z
published: 2025-09-26T07:07:43Z
canonical: "docs.unqork.io/paginated-submissions-api-snippet"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Paginated Submissions API Snippet

## Overview

Pagination is a helpful strategy to make sure your APIs (application programming interfaces) run smoothly. Pagination divides records across multiple pages rather than showing all results at once. The total number of records calculate server-side before they're paginated and returned client-side. The Paginated Submissions API snippet includes an API that’s already set up for pagination. Using limit and offset commands, you can quickly page through your data and display it on a dashboard.

> [!NOTE]
> The Paginated Submissions API snippet works hand-in-hand with the [Paginated Dashboard snippet](/v1/docs/paginated-dashboard-snippet).

Here's how the snippet looks in the Module Builder:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Snippets-Paginated_Submissions_API00.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A54Z&se=2026-11-07T18%3A57%3A54Z&sr=c&sp=r&sig=%2ByypbL2jH43hbEotqry9lVshktvLpiGa%2F%2FS2P%2FGOXBc%3D)

## Adding the Snippet

Before you use this snippet in your application, you must install the snippet to your environment.

### Adding the Snippet to Your Environment

To add the snippet to your environment:

1. Click **Templates** at the top right of the Unqork Designer Platform.
2. Click **Marketplace**.

> [!NOTE]
> You can also access the Marketplace at any time by visiting [https://marketplace.unqork.io](https://marketplace.unqork.io/#/).
3. Enter Paginated Submissions API in the **Search the Listings Directory** field.
4. Click the **Paginated Submissions API** tile.
5. Click **Install to Environment**.
6. Click **Install** **Template**.

> [!NOTE]
> If you aren't logged in, you'll see a field for **Environment URL** and a **Login** button. Enter your environment's URL where you want to install the template. For example: [environmentname.unqork.io]. Click the **Login** button. Then, return to step 4 and click **Install to Environment** again. Follow the remaining steps as listed.

Now, you can now use your newly installed snippet in your application!

### Adding the Snippet to Your Module

Once you install the snippet into your environment, you can drag and drop it right into your module.

1. In the left sidebar of the Module Builder, click the **Snippet****s** button.
2. Enter Paginated Submissions API in the search bar.
3. Drag and drop the **Paginated Submissions API** snippet onto your canvas.

> [!NOTE]
> If you don't see the snippet at first, make sure to expand the **Marketplace Snippets** section.
4. **Save** your module.

## How the Snippet Works

Here are the basic steps of how this snippet works:

1. The Paginated Submissions API snippet retrieves submissions from a schema module. It only retrieves the submissions in batches based on the limit and offset Hidden components. Limit is how many submissions it retrieves at a time. Offset is where in the list it starts.
2. The pluginGetSubmissions Plug-In maps to your schema module and the fields you want to pull.
3. The Plug-In outputs the total number of submissions to the total Hidden component.
4. From there, the dwfMapSubmissions fires, outputting the submissions to the submissions Hidden component.

The Paginated Submissions API snippet works hand-in-hand with the Paginated Dashboard snippet. So, the next step is to link your dashboard module to this Paginated Submissions API module.

## Setting Up the Snippet

To use this snippet, you need a module with a server-side pagination dashboard. We recommend using the Paginated Dashboards snippet. You also need a schema module. The schema module is where you'll pull submissions from.

Here’s what’s required to get the snippet up and running:

1. Properly configure the module to align with Unqork’s API specifications.
2. Update the snippet so it pulls submissions from your schema module.

### Align Module with API Specifications

There are four adjustments you'll make to your module to align it with Unqork's API specifications.

- Add the **api** tag to your module.
- Enable **Server Side Execution Only** in Module Settings.
- Pull all Panels out of the panelAPIServerSidePaginationSnippet Panel.
- Delete the panelAPIServerSidePaginationSnippet Panel.

First, you'll add the **api** tag and adjust the module's settings. From your open module:

1. Click the **More+** button to the right of the module title.
2. Enter api in the **Tags** field. Hit **Enter** or **Return** on your keyboard.
3. Click **Settings** on the left sidebar menu.
4. Set the **Server Side Execution Only** toggle to **ON**.
5. Click **Save Settings**.
6. On the left sidebar, click **Edit** **Module** to return to the Module Builder.

Next, you'll need to move the Panel components.

1. Move the panelInfo, panelRequest, panelConfig, and panelResponse outside of the container panelAPIServerSidePaginationSnippet Panel.
2. Hover over the **panelAPIServerSidePaginationSnippet** Panel.

A 5-button toolbar appears above the component on hover-over.
3. Using the toolbar, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/AppBuildButton_Remove(24).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A54Z&se=2026-11-07T18%3A57%3A54Z&sr=c&sp=r&sig=%2ByypbL2jH43hbEotqry9lVshktvLpiGa%2F%2FS2P%2FGOXBc%3D) (**Remove**) button.
4. **Save** your module.

### Map the Snippet to Your Schema Module

Lastly, you must update the pluginGetSubmissions Plug-In component. You'll map it to your schema module and add the fields you want to pull from your schema module.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Snippets-Paginated_Submissions_PluginBlank.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A54Z&se=2026-11-07T18%3A57%3A54Z&sr=c&sp=r&sig=%2ByypbL2jH43hbEotqry9lVshktvLpiGa%2F%2FS2P%2FGOXBc%3D)

## Removing the Snippet

What if you're no longer interested in using this snippet? No problem. We'll walk you through the quick steps to remove the snippet from your module. Then, you'll learn how to uninstall the snippet from your environment.

### Removing the Snippet from Your Module

Removing a snippet from your module is easy. To remove the [Name of Snippet] snippet:

1. In the Module Builder, hover over the **panelAPIServerSidePaginationSnippet** Panel.

> [!NOTE]
> If you've already moved the other Panels outside of this container Panel, you'll need to delete each individual Panel.
2. Using the toolbar, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/AppBuildButton_Remove(24).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A54Z&se=2026-11-07T18%3A57%3A54Z&sr=c&sp=r&sig=%2ByypbL2jH43hbEotqry9lVshktvLpiGa%2F%2FS2P%2FGOXBc%3D) (**Remove**) button.
3. **Save** your module.

### Removing the Snippet from Your Environment

Use the Unqork Template Library to remove unused snippets. To uninstall a snippet from your environment:

1. At the top right of the Unqork Designer Platform, click **Library** or **Template****s**.
2. Find the snippet you want to uninstall.
3. Click the **ellipsis** (...) in the snippet's tile header.
4. Click **Uninstall** **Template**.
5. Click **Yes, Uninstall** in the confirmation modal.

You can visit the Marketplace and reinstall the snippet at any time.

> [!NOTE]
> What if you have an existing application built using this snippet and then uninstall the snippet from your environment? No problem. Your existing application remains unaffected. Also, your application doesn't have any ties to the snippet. So, let's say you reinstall a newer version of the snippet in the future. You can rest assured that the installation doesn't impact your existing application.