API Documentation
Reference for all Grantverse API endpoints. 12-layer capital stack, grant readiness scoring, outcome tracking, grant matching, investor deal flow, and more. All endpoints are session-authenticated via NextAuth unless marked as public.
Authentication
Session-based via NextAuth.js. Include cookies with requests. OAuth (Google, GitHub) and email/password supported.
Rate Limits
API: 60 requests/min. Auth endpoints: 10 requests/min. Exceeded limits return 429 Too Many Requests.
Error Format
{ "error": string, "details"?: any }HTTP status codes: 400, 401, 403, 404, 429, 500
Authentication
User registration, login, email verification, and password management
Onboarding
Startup and investor onboarding flows
Startup Profile
Manage startup company profiles and metrics
Readiness Score
Capital readiness scoring and history
Grants
Grant discovery, matching, recommendations, and applications
Capital Stack
12-layer capital stack calculation and optimization
Investors
Investor profiles, matching, and deal flow
Dilution Scenarios
advanced dilution modeling and simulation
Intro Requests
Investor-startup introduction requests
Billing
Stripe checkout, subscriptions, and billing management
Messages
Real-time messaging between startups and investors
Admin
Platform administration (admin role required)