Skip to main content
The HoopAI Platform Surveys REST API gives you full programmatic control over your survey data. Retrieve survey lists and paginated submissions, look up individual submission records, schedule CSV exports, generate PDF reports for submissions, clone surveys from themes, and manage images — all through a single, consistent interface.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

Every request requires a Bearer token and an API version header. 
Authorization: Bearer <access_token>
Version: 2021-07-28
Use an access token generated with user type Sub-Account, or a Private Integration Token from a Sub-Account. See OAuth 2.0 for details.

​
OAuth scopes

ScopeAccess granted
surveys.readonlyRead surveys and survey submissions
surveys.writeFull access to surveys and submission management

​
Quick start

List all surveys for a location: 
curl -X GET "https://services.leadconnectorhq.com/surveys/?locationId=<locationId>&limit=20&skip=0" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28"

​
Endpoints

MethodPathDescription
GET/surveys/Get surveys
GET/surveys/submissionsGet surveys submissions
GET/surveys/multiple-surveys-submissionsGet submissions from multiple surveys
GET/surveys/submission/{submissionId}Get submission by ID
GET/surveys/submission-details/{submissionId}Get survey submission details (open)
GET/surveys/surveys-listGet surveys by IDs
POST/surveys/restore-versionRestore a survey version
POST/surveys/schedule-survey-exportSchedule survey submission export as CSV
POST/surveys/clone-from-themeClone survey from theme
GET/surveys/theme-style/{themeId}Get theme style
POST/surveys/imageAdd image in storage
POST/surveys/{surveyId}/submissions/{submissionId}/download-pdfInitiate PDF download for survey submission
GET/surveys/{surveyId}/submissions/{submissionId}/pdf-urlGet PDF URL for survey submission
Last modified on March 4, 2026