API Referencev1.0

Accounting API

Manage customers, invoices, expenses, and accounting data programmatically. Full double-entry bookkeeping with real-time reconciliation.

Customers

GET

/v1/accounting/customers

Retrieve a list of all customers with their associated revenue statistics, invoice counts, and payment history.

Query Parameters

limitOPTIONAL

Maximum number of customers to return (default: 100, max: 1000)

offsetOPTIONAL

Pagination offset for retrieving subsequent pages

Request
curl https://api.taxu.io/v1/accounting/customers \
-H "Authorization: Bearer sk_test_..."
POST

/v1/accounting/customers

Create a new customer contact with billing and payment information.

Request Body

contact_nameREQUIRED

Full name of the customer contact

company_nameOPTIONAL

Company or business name

emailREQUIRED

Customer email address for invoicing

Request
curl https://api.taxu.io/v1/accounting/customers \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
  "contact_name": "John Smith",
  "company_name": "Acme Corp",
  "email": "john@acme.com"
}'

Invoices

POST

/v1/accounting/invoices

Create a new invoice with line items, tax calculations, and payment terms.

Request Body

customer_idREQUIRED

The customer ID to invoice

itemsREQUIRED

Array of line items with description and amount

Request
curl https://api.taxu.io/v1/accounting/invoices \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
  "customer_id": "cust_123",
  "items": [
    {
      "description": "Consulting Services",
      "amount": 500.00
    }
  ]
}'

Expenses

POST

/v1/accounting/expenses

Record a new business expense with automatic categorization and tax deduction tracking.

Request Body

amountREQUIRED

Expense amount in dollars

descriptionREQUIRED

Description of the expense

account_idREQUIRED

Chart of accounts ID (e.g., acc_6100 for office expenses)

Request
curl https://api.taxu.io/v1/accounting/expenses \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
  "amount": 150.00,
  "description": "Office supplies",
  "account_id": "acc_6100"
}'

Full Accounting Features

Beyond basic CRUD operations, Taxu provides complete accounting infrastructure

Double-Entry

Automatic journal entries with debits and credits for all transactions

Real-Time Reconciliation

Match bank transactions to invoices and bills automatically

Tax Calculations

Automatic sales tax, VAT, and income tax calculations