API reference

The Nuvio API is organized around REST. It has predictable, resource-oriented URLs under a versioned path (/v1), accepts and returns JSON with camelCase field names, uses standard HTTP response codes, and authenticates every request with an API key.

An API key belongs to one Nuvio company. Every request reads or writes that company's records: bank accounts and transactions, customers and suppliers, incomes, expenses, payments, products and services, projects, tags and taxes.

Every response has the same envelope: success, errors and data. When a request fails, errors says why; see Errors. Ids are UUIDs and dates are YYYY-MM-DD.

The API works on one record per request; there are no bulk endpoints. Each company can make up to 1,000 requests an hour.

Resources

Accounts & Transactions

• GET /v1/transactions List all Transactions
• POST /v1/transactions Add a new Transaction
• GET /v1/transactions/{id} Get a Transaction by ID
• PUT /v1/transactions/{id} Update Transaction

Bank Accounts

• GET /v1/accounts List all Bank Accounts
• POST /v1/accounts Create a new Bank Account
• GET /v1/accounts/{id} Get a Bank Account by ID
• PUT /v1/accounts/{id} Update Bank Account

Customers & Suppliers

• GET /v1/business-entities List all Customers or Suppliers
• POST /v1/business-entities Create a new Customer or Supplier
• GET /v1/business-entities/{id} Get a Customer or Supplier by ID
• PUT /v1/business-entities/{id} Update Customer or Supplier

Expenses

• POST /v1/list-expenses List all expenses
• GET /v1/expense/{id} Get an Expense by ID
• PUT /v1/expense/{id} Update expense
• POST /v1/expense Create a new Expense

Income

• POST /v1/list-incomes List all incomes
• GET /v1/income/{id} Get an Income by ID
• PUT /v1/income/{id} Update income
• POST /v1/income Create a new Income

Payments

• POST /v1/add-payment Record a new payment
• POST /v1/match-payment/{transactionId} Match payment with an existing Transaction

Products & Services

• GET /v1/product-services List all Products & Services
• POST /v1/product-services Create a new Product or Service
• GET /v1/product-services/{id} Get a Product / Service by ID
• PUT /v1/product-services/{id} Update Product or Service

Projects

• GET /v1/project List all Projects
• POST /v1/project Create a new Project
• GET /v1/project/{id} Get a Project by ID
• PUT /v1/project/{id} Update Project

Tags

• GET /v1/tags List all Tags
• POST /v1/tags Create a new Tag
• GET /v1/tags/{id} Get a Tag by ID
• PUT /v1/tags/{id} Update Tag

Taxes

• GET /v1/tax Tax List

Just getting started?

Create an API key in Nuvio, then send your first request. Authentication shows both.

Not a developer?

Connect Claude, ChatGPT or Grok to Nuvio and work with your books in plain language, no code needed. See Connect an AI agent.

Base URL Copy

https://api.nuvio.io

Rate limit

1,000 requests an hour for each company. A request over the limit gets 429 Too Many Requests; wait and try again.