alpha

Menu

Home Dashboard
Startups Planning New Idea
Marketplace Incubators Accelerators Mentoring
Dealflow Portfolio Due Diligence Startup Opportunities
System Status: Operational

API Reference

Complete reference for the StartupLaunchPad API

On this page

Authentication

These endpoints handle user authentication and token management.

POST /api/auth/login

Login

Authenticate a user and retrieve access and refresh tokens.

Request Body

{
  "email": "user@example.com",
  "password": "your_password"
}

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": 1,
    "email": "user@example.com",
    "full_name": "John Doe",
    "role": "ENTREPRENEUR"
  }
}
POST /api/auth/refresh

Refresh Token

Generate new access token using refresh token.

Request Headers

Authorization: Bearer YOUR_REFRESH_TOKEN

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
POST /api/auth/logout

Logout

Invalidate the current user's token.

Request Headers

Authorization: Bearer YOUR_ACCESS_TOKEN

Response

{
  "message": "Successfully logged out"
}

Ideation

Endpoints for generating and managing startup ideas.

POST /api/startup/ideation/create

Create Startup Idea

Create a new startup idea.

Request Headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request Body

{
  "name": "EcoDelivery",
  "tagline": "Sustainable last-mile delivery",
  "description": "EcoDelivery provides eco-friendly delivery services using electric vehicles and optimized routes to reduce carbon emissions while maintaining fast delivery times.",
  "industry": "logistics",
  "problem_statement": "Urban delivery services contribute significantly to carbon emissions and traffic congestion",
  "solution_description": "Fleet of electric vehicles and AI-optimized routes for eco-friendly urban delivery"
}

Response

{
  "message": "Startup idea created successfully",
  "startup": {
    "id": 1,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "EcoDelivery",
    "tagline": "Sustainable last-mile delivery",
    "stage": "ideation",
    "industry": "logistics"
  }
}
GET /api/startup/ideation/ideas

List Startup Ideas

Get a list of startup ideas for the current user.

Request Headers

Authorization: Bearer YOUR_ACCESS_TOKEN

Query Parameters

Parameter Type Description
page integer Page number (default: 1)
per_page integer Items per page (default: 10)
stage string Filter by startup stage
industry string Filter by industry

Response

{
  "startups": [
    {
      "id": 1,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "EcoDelivery",
      "tagline": "Sustainable last-mile delivery",
      "description": "EcoDelivery provides eco-friendly delivery services...",
      "stage": "ideation",
      "industry": "logistics",
      "validation_score": 0,
      "created_at": "2025-05-20T15:32:10.123456"
    }
  ],
  "page": 1,
  "per_page": 10,
  "total": 1,
  "pages": 1
}

Validation

Endpoints for validating startup ideas and concepts.

Planning

Endpoints for business planning and strategy.