GET a Form Completion from FormWise

The Data API lets send form responses from third party form builders that can be executed using your form, as if it was filled out traditionally on FormWise.

GET all Form IDs

GET https://app.formwise.ai/api/1.1/wf/form_retrieval

This operation will retrieve your Live forms in pagination (25 at once) form.

Headers

Name	Type	Description
Authorization*	Bearer <YOUR-KEY>	Your API Token which can be found on the Account page

200: OK Returns list of Live Forms available for use.

After a successful GET, you will receive an array of your Live Forms along with their ID which is necessary for a #form-completion, along with its Title in the event you want to store this ID and want to reference it later.

Example Response

[ 
  {
    "_id": "1679493702554x213757137604050940",
    "title": "Marketing Feedback Form"
    },
  {
    "_id": "1679493702554x994703839005245400",
    "title": "Facebook Ad Generator"
    }
]

Errors

The Data API runs on certain conditions which may throw errors when you try to Upload form data or Retrieve information about your forms. The most common error will be a 400 Error. There a few things this could mean and ways to remedy them.

• Your Monthly Quota has been exceeded and you cannot process any additional Form Responses.

  • Upgrade your account to a higher tiered plan.

• You are using a Preview Form ID when it should be a Live Form ID.

  • Use the Retrieve Form ID GET request and select a Form or Share a form on your dashboard and copy the ID from the URL.

• Your Account is Locked due to a subscription cancellation.

  • Update your account standing by navigating to the home page and updating your payment settings.

Not returning a Response but no error

If you are not receiving a response upon Form submission, it is possible that the form ID you provided was not created by the user whose account Token is associated with the API call. If you are a collaborator, we recommend using the Token of the Parent account of your organization.