API Overview

The Tonnex API is built with NestJS and runs as a separate application (apps/api).

Base URL

Environment	URL
Local	`http://localhost:3001/api/v1`
Production	`https://api.tonnex.app/api/v1`

Authentication

All protected endpoints require a Bearer token in the Authorization header:

curl -H "Authorization: Bearer <supabase-jwt>" \
  http://localhost:3001/api/v1/health

Health Check

GET /api/v1/health

Response:

{
  "status": "ok",
  "service": "tonnex-api",
  "timestamp": "2026-02-13T10:00:00.000Z"
}

Web Proxy

The Next.js web app proxies /api/v1/* requests to the NestJS API. In development, browser requests to http://localhost:3000/api/v1/* are automatically forwarded to http://localhost:3001/api/v1/*.