onboarding API
Endpoints for onboarding operations.
Endpoints
- POST /api/onboarding/scrape-leagues
- POST /api/onboarding/process-email-candidate
- POST /api/onboarding/process-email-batch
- GET /api/onboarding/pipeline-status
- GET /api/onboarding/pipeline-detailed
- GET /api/onboarding/leagues
- GET /api/onboarding/league/league_id
- PUT /api/onboarding/league/league_id/stage
- POST /api/onboarding/league/league_id/contact
- GET /api/onboarding/recent-activity
- GET /api/onboarding/next-actions
- GET /api/onboarding/email-candidates
- POST /api/onboarding/reset-pipeline
- GET /api/onboarding/stages
- GET /api/onboarding/sports
- GET /api/onboarding/health
POST /api/onboarding/scrape-leagues
Scrape Leagues Endpoint
Scrape websites for league data and populate the database
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/onboarding/scrape-leagues" \
-H "Content-Type: application/json" \
-d '{}'POST /api/onboarding/process-email-candidate
Process Single Email Candidate
Process a single email candidate
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/onboarding/process-email-candidate" \
-H "Content-Type: application/json" \
-d '{}'POST /api/onboarding/process-email-batch
Process Email Batch
Process a batch of email candidates
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/onboarding/process-email-batch" \
-H "Content-Type: application/json" \
-d '{}'GET /api/onboarding/pipeline-status
Get Pipeline Status
Get comprehensive pipeline status and statistics
Responses
200: Successful Response
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/pipeline-status" \
-H "Content-Type: application/json"GET /api/onboarding/pipeline-detailed
Get Detailed Pipeline Status
Get detailed pipeline status with full information
Responses
200: Successful Response
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/pipeline-detailed" \
-H "Content-Type: application/json"GET /api/onboarding/leagues
Get All Leagues
Get all leagues with optional filtering
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
stage | query | string | No | - |
sport | query | string | No | - |
data_source | query | string | No | - |
limit | query | integer | No | - |
offset | query | integer | No | - |
Responses
200: Successful Response
422: Validation Error
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/leagues" \
-H "Content-Type: application/json"GET /api/onboarding/league/{league_id}
Get League Details
Get detailed information about a specific league
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
league_id | path | string | Yes | - |
Responses
200: Successful Response
422: Validation Error
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/league/{league_id}" \
-H "Content-Type: application/json"PUT /api/onboarding/league/{league_id}/stage
Update League Stage
Update the pipeline stage for a league
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
league_id | path | string | Yes | - |
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X PUT "https://api.altsportsdata.com/api/onboarding/league/{league_id}/stage" \
-H "Content-Type: application/json" \
-d '{}'POST /api/onboarding/league/{league_id}/contact
Add Contact Attempt
Add a contact attempt record for a league
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
league_id | path | string | Yes | - |
Request Body
{}Responses
200: Successful Response
422: Validation Error
Examples
curl -X POST "https://api.altsportsdata.com/api/onboarding/league/{league_id}/contact" \
-H "Content-Type: application/json" \
-d '{}'GET /api/onboarding/recent-activity
Get Recent Activity
Get recent pipeline activity
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
days | query | integer | No | - |
Responses
200: Successful Response
422: Validation Error
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/recent-activity" \
-H "Content-Type: application/json"GET /api/onboarding/next-actions
Get Next Actions
Get next actions due within specified days
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
days | query | integer | No | - |
Responses
200: Successful Response
422: Validation Error
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/next-actions" \
-H "Content-Type: application/json"GET /api/onboarding/email-candidates
Get Email Candidates
Get email candidates with optional filtering
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
processed_only | query | boolean | No | - |
matched_only | query | boolean | No | - |
Responses
200: Successful Response
422: Validation Error
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/email-candidates" \
-H "Content-Type: application/json"POST /api/onboarding/reset-pipeline
Reset Pipeline
Reset the entire pipeline (for testing/development)
Responses
200: Successful Response
Examples
curl -X POST "https://api.altsportsdata.com/api/onboarding/reset-pipeline" \
-H "Content-Type: application/json"GET /api/onboarding/stages
Get Available Stages
Get all available pipeline stages
Responses
200: Successful Response
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/stages" \
-H "Content-Type: application/json"GET /api/onboarding/sports
Get Available Sports
Get all sports represented in the pipeline
Responses
200: Successful Response
Examples
curl -X GET "https://api.altsportsdata.com/api/onboarding/sports" \
-H "Content-Type: application/json"