Skip to main content
GET
/
surveys
/
submissions
Get Surveys Submissions
curl --request GET \
  --url https://services.leadconnectorhq.com/surveys/submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Version: <version>'
{
  "submissions": [
    {
      "id": "be759b9a-c3ec-4b29-ba07-fc3c89c77673",
      "contactId": "9NkT25Vor1v4aQatFsv2",
      "createdAt": "2020-11-01T18:02:21.000Z",
      "surveyId": "jjusM6EOngDExnbo2DbU",
      "name": "test",
      "email": "test@test.com",
      "others": {
        "__submissions_other_field__": "john@deo.com",
        "__custom_field_id__": "20",
        "eventData": {
          "fbc": "fb.1.123456789.987654321",
          "fbp": "fbp.1.987654321.123456789",
          "page": {
            "url": "https://example.com",
            "title": "Example Page"
          },
          "type": "page-visit",
          "domain": "example.com",
          "medium": "survey",
          "source": "Direct traffic",
          "version": "v3",
          "adSource": "example-ad-source",
          "mediumId": "medium-id-123",
          "parentId": "parent-id-456",
          "referrer": "https://staging.hoopai.com",
          "fbEventId": "event-id-789",
          "timestamp": 1234567890,
          "parentName": "Parent Survey",
          "fingerprint": "example-fingerprint",
          "pageVisitType": "survey",
          "contactSessionIds": {
            "ids": [
              "session1",
              "session2"
            ]
          }
        },
        "fieldsOriSequance": [
          "full_name",
          "first_name",
          "last_name",
          "phone",
          "email"
        ]
      }
    }
  ],
  "meta": {
    "total": 1,
    "currentPage": 1,
    "nextPage": null,
    "prevPage": null
  }
}

Authorizations

​
Authorization
string
header
required

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Headers

​
Version
enum<string>
required

API Version

Available options:
2021-07-28

Query Parameters

​
locationId
string
required
Example:

"ve9EPM428h8vShlRW1KT"

​
page
number
default:1

Page No. By default it will be 1

Example:

1

​
limit
number
default:20

Limit Per Page records count. will allow maximum up to 100 and default will be 20

Example:

20

​
surveyId
string

Filter submission by survey id

Example:

"jjusM6EOngDExnbo2DbU"

​
q
string

Filter by contactId, name, email or phone no.

Example:

"john@deo.com"

​
startAt
string

Get submission by starting of this date. By default it will be same date of last month(YYYY-MM-DD).

Example:

"2020-11-14"

​
endAt
string

Get submission by ending of this date. By default it will be current date(YYYY-MM-DD).

Example:

"2020-12-14"

Response

Successful response

​
submissions
object[]
​
meta
object
Last modified on March 8, 2026