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
OAuth scopes
| Scope | Access granted |
|---|
surveys.readonly | Read surveys and survey submissions |
surveys.write | Full 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
| Method | Path | Description |
|---|
GET | /surveys/ | Get surveys |
GET | /surveys/submissions | Get surveys submissions |
GET | /surveys/multiple-surveys-submissions | Get 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-list | Get surveys by IDs |
POST | /surveys/restore-version | Restore a survey version |
POST | /surveys/schedule-survey-export | Schedule survey submission export as CSV |
POST | /surveys/clone-from-theme | Clone survey from theme |
GET | /surveys/theme-style/{themeId} | Get theme style |
POST | /surveys/image | Add image in storage |
POST | /surveys/{surveyId}/submissions/{submissionId}/download-pdf | Initiate PDF download for survey submission |
GET | /surveys/{surveyId}/submissions/{submissionId}/pdf-url | Get PDF URL for survey submission |
Last modified on March 5, 2026
