TABLE OF CONTENTS

  • Parameters
  • Example

 

ADDITIONAL INFO

 

The GET Formentry API returns the form entry matching the given parameters.

 

On the Cloud, this API is available via SSL-secured HTTPS connection using the REST GET verb.


The format query string parameter controls the desired response format.  Specify either XML or JSON.


 

/api/v2/datasource?format=xml/json


Parameters


The GET verb allows you to return all the response data from any form submission matching the given parameters.


The required and optional parameters for a GET call to the Formentry API are outlined below.
 

Name

Type

Description

Required

CompanyId

Integer

Your unique Company ID is found on the Organization Setup page of the secure website.

✓

IntegrationKey

String

Your unique Integration Key is found on the Organization Setup page of the secure website.

✓

AnswerFormat

String

Whether or not to return rich answers or raw answers.


Id

String

The Form Entry's unique identifier.

✓

MediaAsUrl

Boolean

Returns Media answers as full file download URLs instead of just the file name.
 


Fields

String

Optionally restrict returned answer values to the given comma-separated list of field data names.

ONLY SUPPORTED WITH 'FLAT' ANSWERFORMAT.


Example

 

Given that the API is REST-based, you can access the API directly via your web browser to test it using a REST plugin like the Postman plugin for Google Chrome.


 

Request URL

https://secure.amplusforms.com:443/api/v2/formentry?AnswerFormat=Raw&CompanyId=XXXXX&IntegrationKey=78eec3032af2XXXXXXXXXXXXXXX&Id=930705bb-0990-XXXX-a890-XXXXXXX&&

 

Response Body 

{

  "Entry": {

    "Id": "930705bb09904fXXXXXXXXXXXX",

    "RowId": 1,

    "FormId": "59adbe4dc6b84XXXXXXXXXXXX",

    "FormVersion": 1,

    "DeviceId": "d7e5e330360c4edXXXXXXXXXXXX",

    "UserFirstName": "Griffin",

    "UserLastName": "Smith",

    "UserEmail": "XXXbox@amplusforms.com.com",

    "UserExternalId": "GameOn123",

    "Latitude": -82.74939,

    "Longitude": 81.780396,

    "StartTime": "2024-10-01T10:10:36.5070000Z",

    "CompleteTime": "2024-10-01T10:17:16.6670000Z",

    "ReceivedTime": "2024-10-01T10:17:17.5500000Z",

    "AnswerFormat": "Raw",

    "AnswersRawJson": {

      "page1": {

        "table": [

          {

            "nearestDate_DS": "",

            "id": "QCPAV6",

            "category": "A",

            "name": "QCP",

            "date": "2024-08-01T10:30:50Z",

            "btnNav1": "Add+"

          },

          {

            "nearestDate_DS": "",

            "id": "QP42H5",

            "category": "B",

            "name": "QP4",

            "date": "2024-07-02T10:30:59Z",

            "btnNav1": "Back^"

          },

          {

            "nearestDate_DS": "",

            "id": "6VNGN1",

            "category": "B",

            "name": "6VN",

            "date": "2024-06-02T10:30:16Z",

            "btnNav1": "Back^"

          },

          {

            "nearestDate_DS": "",

            "id": "8SIUYR",

            "category": "C",

            "name": "8SI",

            "date": "2024-05-03T10:30:28Z",

            "btnNav1": "Back^"

          },

          {

            "nearestDate_DS": "",

            "id": "J5S9EY",

            "category": "C",

            "name": "J5S",

            "date": "2024-04-03T10:30:48Z",

            "btnNav1": "Back^"

          },

          {

            "nearestDate_DS": "",

            "id": "1HPV4F",

            "category": "C",

            "name": "1HP",

            "date": "2024-03-03T10:30:08Z",

            "btnNav1": "Back^"

          }

        ]

      }

    },

    "DSRowId": "930705bb-0990-XXXXX-a890-XXXXXXXXXXX",

    "CompanyId": XXXXX

  }

}