API Reference

REST API for the Personal Finances frontend. All endpoints are under /api/v2/.

Base URL

Production: https://personal-finances-backend.onrender.com
Development: http://localhost:8000

Authentication

All /api/v2/* routes require a Supabase Auth JWT:

Authorization: Bearer <jwt>

The JWT is obtained after login via Supabase Auth and stored in the session cookie. It is sent automatically by the frontend on every API call.

Common Error Codes

CORS

Accepts origins matching *.nathanfiorito.com.br with methods GET, POST, PUT, PATCH, DELETE.

Health Check

GET /health

Response 200 OK:

{ "status": "ok" }

No authentication required.