Overview

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_TOKEN

Public 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 limit
• X-RateLimit-Remaining: Requests remaining
• X-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/.

• IndepAI Support: https://indepai.app/help - support@indepai.app
• License: Proprietary
• OpenAPI version: 3.1.0

Authentication

bearerAuth

Supabase access token. Obtain via /auth/login or Supabase client.

Security scheme type: http

Bearer format: JWT