> ## Documentation Index
> Fetch the complete documentation index at: https://docs.billbora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

# 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.

<img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/billbora/images/hero-light.svg" alt="Hero Light" />

<img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/billbora/images/hero-dark.svg" alt="Hero Dark" />

## What is Billbora?

Billbora provides a complete invoicing and payment management solution with:

<CardGroup cols={2}>
  <Card title="Multi-Tenant Architecture" icon="building" href="/guides/multi-tenant-setup">
    Organization-based data isolation with role-based access control
  </Card>

  <Card title="Payment Processing" icon="credit-card" href="/resources/payments">
    Integrated Stripe payments with BYOK (Bring Your Own Key) support
  </Card>

  <Card title="Real-time Webhooks" icon="webhook" href="/webhooks/overview">
    Event-driven integrations for seamless workflow automation
  </Card>

  <Card title="TypeScript SDK" icon="code" href="/sdk/typescript">
    Fully typed SDK with React hooks for modern web development
  </Card>
</CardGroup>

## 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

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running with your first API call in under 5 minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn about our hybrid Supabase + JWT authentication system
  </Card>

  <Card title="Frontend Integration" icon="browser" href="/guides/frontend-integration">
    Complete guide for integrating with React and TypeScript
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Comprehensive API documentation with interactive examples
  </Card>
</CardGroup>

## SDK and Libraries

We provide official SDKs and libraries to make integration easier:

<Tabs>
  <Tab title="TypeScript/JavaScript">
    ```bash theme={null}
    npm install @billbora/sdk
    ```

    ```typescript theme={null}
    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'
      }]
    })
    ```
  </Tab>

  <Tab title="React Hooks">
    ```bash theme={null}
    npm install @billbora/react
    ```

    ```tsx theme={null}
    import { useInvoices, useCreateInvoice } from '@billbora/react'

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

  <Tab title="Python">
    ```bash theme={null}
    pip install billbora-python
    ```

    ```python theme={null}
    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'
        }]
    })
    ```
  </Tab>
</Tabs>

## API Fundamentals

### Base URL

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

### Authentication

Billbora uses a hybrid authentication system:

1. **Supabase Authentication** for user login
2. **JWT Token Exchange** for API access with organization context
3. **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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="E-commerce Automation">
    Streamline your e-commerce billing:

    * Order-to-invoice automation
    * B2B customer invoicing
    * Payment reconciliation
    * International sales support
  </Accordion>

  <Accordion title="Service Business Management">
    Manage client billing for service businesses:

    * Time tracking to invoice conversion
    * Project-based billing
    * Client portal integration
    * Automated payment reminders
  </Accordion>

  <Accordion title="Marketplace Payments">
    Handle complex marketplace transactions:

    * Split payments between vendors
    * Platform fee management
    * Vendor payout automation
    * Tax compliance per jurisdiction
  </Accordion>
</AccordionGroup>

## Support and Community

<CardGroup cols={3}>
  <Card title="Documentation" icon="book-open" href="https://docs.billbora.com">
    Comprehensive guides and tutorials
  </Card>

  <Card title="Community Forum" icon="users" href="https://community.billbora.com">
    Get help from other developers
  </Card>

  <Card title="Support" icon="life-ring" href="mailto:api-support@billbora.com">
    Direct support from our team
  </Card>
</CardGroup>

## What's Next?

Ready to start building? Here are your next steps:

<Steps>
  <Step title="Get API Access">
    Sign up for a Billbora account and generate your API credentials
  </Step>

  <Step title="Follow the Quickstart">
    Make your first API call and create an invoice in under 5 minutes
  </Step>

  <Step title="Explore the SDK">
    Install our TypeScript SDK or React hooks for rapid development
  </Step>

  <Step title="Set up Webhooks">
    Configure real-time event notifications for your application
  </Step>
</Steps>

<Card title="Ready to get started?" icon="arrow-right" href="/quickstart">
  Follow our quickstart guide to make your first API call
</Card>