Introduction

Welcome to the Billbora API documentation! Billbora is a comprehensive invoice management platform designed for small to medium businesses, offering powerful APIs for seamless integration with your applications. Hero Light

What is Billbora?

Billbora provides a complete invoicing and payment management solution with:

Multi-Tenant Architecture

Organization-based data isolation with role-based access control

Payment Processing

Integrated Stripe payments with BYOK (Bring Your Own Key) support

Real-time Webhooks

Event-driven integrations for seamless workflow automation

TypeScript SDK

Fully typed SDK with React hooks for modern web development

Core Features

Invoice Management

Complete invoice lifecycle management from creation to payment, including:

Automated invoice generation
PDF creation and delivery
Payment tracking and reconciliation
Overdue management and reminders

Client Relationship Management

Comprehensive client management with:

Contact information and history
Invoice history and analytics
Payment preferences and methods
Communication tracking

Subscription Billing

Advanced recurring billing capabilities:

Flexible billing cycles and schedules
Usage-based billing support
Subscription tier management
Automated payment collection

Multi-Currency Support

Global business operations with:

Real-time exchange rates
Multi-currency invoicing
Automatic currency conversion
Localized formatting

Getting Started

Quickstart

Get up and running with your first API call in under 5 minutes

Authentication

Learn about our hybrid Supabase + JWT authentication system

Frontend Integration

Complete guide for integrating with React and TypeScript

API Reference

Comprehensive API documentation with interactive examples

SDK and Libraries

We provide official SDKs and libraries to make integration easier:

TypeScript/JavaScript
React Hooks
Python

npm install @billbora/sdk

import { BillboraAPI } from '@billbora/sdk'

const client = new BillboraAPI({
  apiKey: 'your-api-key'
})

const invoice = await client.invoices.create({
  client: 'client-id',
  line_items: [{
    description: 'Consulting Services',
    quantity: 10,
    unit_price: '150.00'
  }]
})

npm install @billbora/react

import { useInvoices, useCreateInvoice } from '@billbora/react'

function InvoiceList() {
  const { data: invoices, isLoading } = useInvoices()
  const createInvoice = useCreateInvoice()
  
  // Your component logic
}

pip install billbora-python

import billbora

client = billbora.Client(api_key='your-api-key')

invoice = client.invoices.create({
    'client': 'client-id',
    'line_items': [{
        'description': 'Consulting Services',
        'quantity': 10,
        'unit_price': '150.00'
    }]
})

API Fundamentals

Base URL

All API endpoints are relative to: https://api.billbora.com/api/v1

Authentication

Billbora uses a hybrid authentication system:

Supabase Authentication for user login
JWT Token Exchange for API access with organization context
API Keys for server-to-server integration

Rate Limits

General API: 1,000 requests per hour per user
Authentication: 10 requests per minute per IP
Webhooks: 50 requests per minute per endpoint

Response Format

All API responses follow a consistent JSON format:

{
  "data": {
    "id": "inv_1234567890",
    "invoice_number": "INV-001",
    "status": "draft"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

Error Handling

Errors include detailed information for debugging:

{
  "error": {
    "code": "validation_error",
    "message": "Invalid input data",
    "details": {
      "email": ["Must be a valid email address"]
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

Use Cases

SaaS Platform Integration

Integrate invoicing directly into your SaaS platform:

Automated billing for subscriptions
Usage-based invoicing
Multi-tenant invoice management
White-label invoice customization

E-commerce Automation

Streamline your e-commerce billing:

Order-to-invoice automation
B2B customer invoicing
Payment reconciliation
International sales support

Service Business Management

Manage client billing for service businesses:

Time tracking to invoice conversion
Project-based billing
Client portal integration
Automated payment reminders

Marketplace Payments

Handle complex marketplace transactions:

Split payments between vendors
Platform fee management
Vendor payout automation
Tax compliance per jurisdiction

Support and Community

Documentation

Comprehensive guides and tutorials

Community Forum

Get help from other developers

Support

Direct support from our team

What’s Next?

Ready to start building? Here are your next steps:

Get API Access

Follow the Quickstart

Make your first API call and create an invoice in under 5 minutes

Explore the SDK

Install our TypeScript SDK or React hooks for rapid development

Set up Webhooks

Configure real-time event notifications for your application

Ready to get started?

Follow our quickstart guide to make your first API call

Get Started

Integration

​Introduction

​What is Billbora?

Multi-Tenant Architecture

Payment Processing

Real-time Webhooks

TypeScript SDK

​Core Features

​Invoice Management

​Client Relationship Management

​Subscription Billing

​Multi-Currency Support

​Getting Started

Quickstart

Authentication

Frontend Integration

API Reference

​SDK and Libraries

​API Fundamentals

​Base URL

​Authentication

​Rate Limits

​Response Format

​Error Handling

​Use Cases

​Support and Community

Documentation

Community Forum

Support

​What’s Next?

Ready to get started?

Introduction

What is Billbora?

Core Features

Invoice Management

Client Relationship Management

Subscription Billing

Multi-Currency Support

Getting Started

SDK and Libraries

API Fundamentals

Base URL

Authentication

Rate Limits

Response Format

Error Handling

Use Cases

Support and Community

What’s Next?