API Overview

VerseBill exposes a set of internal API routes. All state-changing routes require authentication except the public pay/verify routes, which are rate-limited and operate on public invoice IDs.

Routes

• •POST /api/me — provision or update the authenticated user and merchant
• •GET /api/invoices — list the merchant's invoices (filter, cursor, take)
• •POST /api/invoices — create an invoice
• •GET /api/invoices/[id] — fetch one invoice
• •POST /api/invoices/[id]/publish — publish a draft invoice
• •POST /api/invoices/[id]/cancel — cancel an invoice
• •GET /api/dashboard/stats — dashboard summary statistics
• •GET /api/pay/[publicId] — public payment details for an invoice
• •POST /api/pay/[publicId]/submit — submit a transaction hash
• •POST /api/payments/[id]/verify — re-run verification for a payment
• •GET /api/verify/[publicId] — public verification status
• •GET /api/settings — merchant settings
• •PATCH /api/settings — update merchant settings
• •GET /api/settings/wallet — wallet address and balances
• •GET /api/health — service health and configuration status