questionnaire API
Endpoints for questionnaire operations.
Endpoints
- POST /api/questionnaire/process-questionnaire
- GET /api/questionnaire/health
- POST /api/questionnaire/extract
- POST /api/questionnaire/classify-tier
- POST /api/questionnaire/generate-contract
- GET /api/questionnaire/download/contract_id"}/format"}
POST /api/questionnaire/process-questionnaire
Process Questionnaire
Process uploaded questionnaire (PDF/DOCX/TXT)
Flow:
- Extract data from questionnaire
- Generate league fingerprint
- Assess partnership readiness
- Generate pricing tiers (4 tiers)
- Create contracts (DOCX + PDF)
- Return comprehensive results
Returns:
- Extracted questionnaire data
- Readiness assessment (score, tier, recommendations)
- Termsheet with 4 pricing structures
- Contract documents (optional)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
X-API-Key | header | string | No | - |
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/questionnaire/process-questionnaire" \
-H "Content-Type: application/json" \
-d '{}'GET /api/questionnaire/health
Health Check
Health check for questionnaire service Tests dependencies: OpenAI, Google Cloud, file system
Responses
200: Successful Response
Examples
curl -X GET "https://api.altsportsdata.com/api/questionnaire/health" \
-H "Content-Type: application/json"POST /api/questionnaire/extract
Extract Questionnaire Data
Extract data from questionnaire without generating contracts Faster endpoint for data extraction only
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
X-API-Key | header | string | No | - |
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/questionnaire/extract" \
-H "Content-Type: application/json" \
-d '{}'POST /api/questionnaire/classify-tier
Classify Tier
Classify league tier based on questionnaire data Returns: Premium/Growth/Standard/Emerging tier
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
X-API-Key | header | string | No | - |
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/questionnaire/classify-tier" \
-H "Content-Type: application/json" \
-d '{}'POST /api/questionnaire/generate-contract
Generate Contract
Generate contracts from already-extracted questionnaire data Faster than full pipeline if data is already available
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
X-API-Key | header | string | No | - |
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/questionnaire/generate-contract" \
-H "Content-Type: application/json" \
-d '{}'GET /api/questionnaire/download/{contract_id}"}/{format}"}
Download Contract
Download generated contract in specified format Formats: pdf, docx, json
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
contract_id | path | string | Yes | - |
format | path | string | Yes | - |
Responses
200: Successful Response
422: Validation Error
Examples
curl -X GET "https://api.altsportsdata.com/api/questionnaire/download/{contract_id}"}/{format}"}" \
-H "Content-Type: application/json"