123FormBuilder API – Retrieve Submissions

Important Note

This version of the API was deprecated. If you still need to automate your data collection processes, and retrieve collected data or make various operations related to your 123FormBuilder account through API calls, you can use our new and improved API v2. Please visit our developer documentation for more details.

If you’re using our HTML form generator, here’s where you can learn how to retrieve submissions using the 123FormBuilder API.

The Retrieve Submissions action is a little more complex than the others. It returns details about the submissions of a certain form.

You can obtain the Page URL from our knowledge base for developers.

The pageNr and pageSize POST parameters can be used to determine the pagination in cases of forms with many submissions. By default, pageNr is 0 and pageSize is 25. When stated explicitly, the pageSize value must be between 25 and 100.

pageSize represents the number of submissions displayed on one page.

pageNr multiplied by pageSize represents the number of the submission with which displaying will start.

The submissions in the output can be ordered by the sort parameter, which can have one of the following values: ASC or DESC. Submissions are sorted chronologically, in ascending order (oldest → newest) or in descending order (newest → oldest).

For more advanced capabilities, we highly recommend you to use API V2.


  1. Can I specify a filter and choose which fields to return? Like I want to get submissions for one day. If yes, where can I find more details about this api? This isn’t enough documentation.

    1. Hello! You can retrieve all the submissions from the form, but you can not filter them. However, you can use a script to filter the data received. For more information about API, feel feel to check out this page.

  2. Although I am able to retrieve other apis, when i process with submissions I receive ‘You are not allowed to view this page!’ error.

    1. For this kind of situations, please address your need of assistance to our Customer Care team. Please provide them as many details as possible to start an investigation(steps to reproduce the issue, screenshots, etc). Get in touch with them directly from your account or from our Contact Page. They will be more than happy to assist you.
      Thank you!

Leave a Reply

Your email address will not be published. Required fields are marked *

Frequently Asked Questions

Here is a list of the most frequently asked questions. For more FAQs, please browse through the  FAQs page.

Is this service free?
Yes, we offer a free form builder service. Just sign up to the Basic plan and you are all set. This plan is forever free, but you are limited with a few features only, such as 5 forms per account, 100 submissions per month and you have to keep the backlink to 123FormBuilder on your forms. Check out our features matrix for more information.
How many forms can I create?
It depends on the service plan you are on. Higher service plans enable more features, including more web forms for your account. If you need more forms, go to the My Account section of your account and click the upgrade button. To create an unlimited number of forms, either upgrade to the Platinum service plan or higher. Consult our features matrix for more information.
How can I publish my forms?
You can publish your forms in many ways, by using their direct URL or HTML link, embedding them with a JavaScript code, Inline HTML or iFrame, using the Facebook app or the WordPress plugin, using popups, the Blogger code snippet and many more. Once you have created and customized your form, go to the Publish section to complete your work. Read more in our documentation.
How do I change my form design?
You can change the design of your form for more information. in the Themes section, which is located in your form settings. We offer a set of more than 30 predefined form themes for your forms, but you can also create your own from scratch. You can customize the submit button, the logo and more. To apply your own stylesheets, all forms come with a custom CSS editor.

Can't find what you're looking for?