Kobana

Your finances available via API

10 REST resources with JWT authentication, operation scopes, cursor pagination and idempotency on writes. The same business rules as the UI — no backdoor, no parallel logic.

Public API
See API documentationSchedule a demo
Smart Finance Public API
10
available resources
OpenAPI 3
spec available
Cursor
pagination
JWT + scopes
authentication

10 resources, complete back-office coverage

Financial Accounts
accounts

List and query financial accounts. Real-time calculated balance returned in the response.

Categories
categories

Read the complete chart of accounts (3 levels). Integrate with your ERP to keep categories in sync.

Cost Centers
cost_centers

List cost centers for populating forms in external systems.

Companies
companies

List workspace companies. Useful for integrating multi-company reports in external dashboards.

People
people

Full CRUD of vendors and customers with CPF/CNPJ validation.

Taxes
taxes

List and query withholding taxes configured in the workspace.

Accounts Payable
payables

Full CRUD. Create, read, update and list with filters by status, due date, vendor and category.

Accounts Receivable
receivables

Full CRUD. Same structure as payables for integration consistency.

Transactions
transactions

List and query financial account transactions with date and amount filters.

Attachments
attachments

Upload, download and list files. Secure streaming download with authentication.

API built for production integration

Bearer JWT Authentication
JWT token in Authorization: Bearer header. Granular scopes per resource and operation (finance.payables, finance.payables.write).
  • Independent scopes per resource
  • Read/write separation
  • Same tenant validation as UI
Cursor Pagination
Stable pagination for large data volumes. The cursor guarantees consistent results even with data being created during iteration.
  • cursor and per_page in parameters
  • next_cursor in response
  • No skips or duplicates
Idempotency on Writes
Send the Idempotency-Key header on create operations. Re-sends with the same key return the original result without creating duplicates.
  • Idempotency-Key header on mutations
  • Safe for retry on network failures
  • Result cached for 24h
Native Multi-tenant
JWT determines the workspace. Impossible to access another tenant's data. All queries are scoped by the token's workspace_id.
  • Total isolation per workspace
  • No tenant parameter in path
  • Same security as UI
Same Business Rules
The API uses the same services, validations and automatic rules as the interface. Creating an entry via API triggers the same classification rules.
  • CPF/CNPJ validation
  • Automatic rules fire
  • No parallel logic or backdoor
OpenAPI 3 Available
Complete specification at /public/openapi-v1.yaml. Interactive viewer with Scalar at /docs. Import directly into Postman, Insomnia or any REST client.
  • Complete schemas per resource
  • Request/response examples
  • Testable directly in browser

Integrate in minutes

Example of creating an accounts payable entry via API:

curl -X POST https://app.finance.kobana.com.br/api/v1/payables \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "description": "Vendor ABC - Invoice 1234",
    "amount": 5000.00,
    "due_date": "2026-07-15",
    "person_id": "per_abc123",
    "category_id": "cat_xyz456",
    "company_id": "cmp_def789"
  }'

Frequently asked questions

Integrate your ERP or legacy system

The REST API allows your system to remain the system of record — and Smart Finance comes in as the automation and payments layer.

See API documentationSee all features
Schedule