Skip to main content

HTTP API reference

Extraction and invoice routes accept Authorization: Bearer with a bf_live_ API key or session JWT. Create and revoke bf_live_ keys only from the signed-in dashboard (not documented here). Billing and subscription webhooks are handled in the product UI, not in this catalog.

How the pieces connect

Extract first, then list or update saved rows. Each box links to a topic page with every method and path listed.

Extract
Invoices

Complete endpoint index

MethodPathTopicSummaryDetails
POST/api/expensesExtractionExtract one or many expense documents (JSON file_url/items or multipart files). client_id required.View
POST/api/revenueExtractionExtract one or many revenue documents (same shape as POST /api/expenses). client_id required.View
GET/api/expensesInvoicesPaginated expense invoices for a client (client_id query required).View
GET/api/expenses/[id]InvoicesFetch one expense invoice by id.View
PATCH/api/expenses/[id]InvoicesMerge parsed_data on an expense invoice.View
DELETE/api/expenses/[id]InvoicesDelete an expense invoice.View
GET/api/revenueInvoicesPaginated revenue invoices for a client (client_id query required).View
GET/api/revenue/[id]InvoicesFetch one revenue invoice by id.View
PATCH/api/revenue/[id]InvoicesMerge parsed_data on a revenue invoice.View
DELETE/api/revenue/[id]InvoicesDelete a revenue invoice.View
GET/api/clientsClientsList clients for the authenticated organization.View
POST/api/clientsClientsCreate a client under the organization.View
GET/api/clients/[id]ClientsFetch one client by id.View