IndepAI Support
Overview
IndepAI API 1.0.0
Section titled “IndepAI API 1.0.0”IndepAI REST API
Welcome to the IndepAI API documentation. This API provides programmatic access to Financial Independence calculations, portfolio management, geo-arbitrage tools, and tax optimization.
Authentication
Most endpoints require authentication via Bearer token. Include your Supabase access token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKENPublic endpoints (like the FI Calculator) can be used without authentication but have stricter rate limits.
Rate Limiting
Rate limits are based on your subscription tier:
| Tier | Daily Limit | Per-Endpoint Limits |
|---|---|---|
| Starter | 1,000 requests | 50 AI Coach requests |
| Pro | 10,000 requests | 500 AI Coach requests |
Rate limit headers are included in all responses:
X-RateLimit-Limit: Your daily limitX-RateLimit-Remaining: Requests remainingX-RateLimit-Reset: Unix timestamp when limit resets
Errors
All errors follow a consistent format:
{
"success": false,
"error": "Error Type",
"code": "ERROR_CODE",
"details": [
{ "path": "fieldName", "message": "Error description" }
]
}Common Error Codes
| Code | Description |
|---|---|
| VALIDATION_ERROR | Request body failed validation |
| UNAUTHORIZED | Missing or invalid authentication |
| FORBIDDEN | Insufficient permissions |
| NOT_FOUND | Resource not found |
| RATE_LIMITED | Rate limit exceeded |
| INTERNAL_ERROR | Server error |
Versioning
The API uses URL versioning. The current version is v1. All endpoints are prefixed with /api/v1/.
Authentication
Section titled “Authentication”bearerAuth
Section titled “bearerAuth”Supabase access token. Obtain via /auth/login or Supabase client.
Security scheme type: http
Bearer format: JWT