API Overview

Base URL

All paths are prefixed with /api (except /health).

Authentication

Most endpoints require the Web3Auth idToken as a bearer token:

Authorization: Bearer <idToken>

The api-client.ts wrapper attaches this automatically from localStorage.

Error Shape

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable message"
  }
}

Health Check

GET /health

{
  "status": "ok",
  "service": "fluxpay-backend",
  "storage": "postgres"
}