API Endpoints Reference

Complete documentation for StartupVision API endpoints.

Validations

List Validations

GET /validations

Query parameters:

• `limit` (integer): Results per page (max 100)
• `offset` (integer): Pagination offset
• `status` (string): Filter by status

Get Validation

GET /validations/:id

Create Validation

POST /validations

Request body:

{
  "description": "Your startup description",
  "industry": "fintech",
  "stage": "idea|mvp|growth",
  "targetMarket": "B2B|B2C|B2B2C"
}

Delete Validation

DELETE /validations/:id

Documents

List Documents

GET /documents

Get Document

GET /documents/:id

Create Document

POST /documents

Request body:

{
  "type": "iso27001|soc2|gdpr|hipaa",
  "validationId": "optional-validation-id",
  "customization": {
    "companyName": "Your Company"
  }
}

Webhooks

List Webhooks

GET /webhooks

Create Webhook

POST /webhooks

Request body:

{
  "url": "https://your-server.com/webhook",
  "events": ["validation.completed", "document.ready"]
}

Response Format

All responses follow this format:

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_123",
    "timestamp": "2024-01-15T12:00:00Z"
  }
}

Error responses:

{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "Description is required",
    "field": "description"
  }
}