Login

BridgeXX Gateway

Enterprise API Gateway for AI Agents

System Status

OPERATIONAL
OAuth 2.0 Gateway | PostgreSQL Backend | Xero API Integration

API Endpoints

Authentication & OAuth

GET /oauth/authorize
Start OAuth 2.0 authorization flow for Xero connection
GET /oauth/callback
OAuth callback endpoint for Xero authorization
POST /oauth/token
Exchange authorization code for access token

Multi-Tenant Management

GET /api/tenants
List all connected Xero organizations for the authenticated user
GET /api/tenants/check
Check if a specific organization is connected (supports natural language search)
POST /api/tenants/select
Switch active organization by name or tenant ID

Xero Data Endpoints

GET /api/invoices
Fetch invoices (accounts receivable) with pagination and filtering
GET /api/invoices/summary
Get aggregated invoice summary with totals and status breakdown
GET /api/bills
Fetch bills (accounts payable) with pagination and filtering
GET /api/bills/summary
Get aggregated bills summary with totals and status breakdown
GET /api/contacts
Fetch contacts (customers/suppliers) with search and pagination
GET /api/accounts
Fetch chart of accounts with filtering by type and class
GET /api/bank-transactions
Fetch bank transactions with date range and account filtering

Reports

GET /api/reports/aged-receivables-summary
Generate aged receivables report with overdue analysis
GET /api/reports/:reportType
Generate Xero reports (ProfitAndLoss, BalanceSheet, etc.)

System

GET /api
API documentation and version information
GET /health
Health check endpoint for monitoring and uptime