# Wave — Accounting API: overview

> Canonical URL: https://developers.apideck.com/apis/accounting/wave/overview

Free accounting and invoicing software for small businesses. Includes invoicing, accounting, receipt scanning, and financial reporting.
- Status: live
- Authentication: oauth2

- **account type required:** A Wave business in the US or Canada with an active Pro or Advisors subscription. This includes the business you test your own app with.
- **apideck credentials available:** false
- **apideck credentials note:** Register your own Wave application and add its Client ID and Secret to Apideck.
- **authentication note:** Authorization Code flow. Wave's API is GraphQL-only; each connection is tied to one Wave business, whose ID is captured during authorisation.
- **beta:** false
- **consumer access level:** Any user with access to the business can authorise the connection; Wave publishes no role requirement.
- **costs:** Wave charges no API access fees and commits to advance notice before introducing any. The subscription requirement sits on the connecting business, not you.
- **difficulty:** moderate
- **difficulty reason:** Self-Service OAuth App + Wave Approval Required to Distribute
- **environment notes:**   - **description:** Testing and production share one Wave host and one credential shape, because Wave runs no sandbox. To test: use a Wave business on the Pro plan or Wave Advisors, since Wave's authorization screen will not let you select a free Starter business, even your own; or request Apideck temporary shared test credentials at https://help.apideck.com/en/articles/7774658.
  - **environment:** Single environment
  - **description:** Set a VPN to the US or Canada and use an email address you have not tried before, then create the business as US-based with USD as its currency. Getting this wrong on the first attempt tags the address permanently, and no later attempt from that address succeeds. If you are already blocked, Wave can unblock addresses manually on request.
  - **environment:** Signing up from outside North America
  - **description:** A test Business sits in the same Wave account as any real books you keep there, and the Business ID is the only thing separating them at connection time. Check which one you have connected before writing.
  - **environment:** Caution
- **important to know:** A live connection can break with nothing changing on your side. If a connected business's Wave Pro or Advisors subscription lapses, the next token refresh returns 403 and the integration stops working until the subscription is reactivated.
Distributing your integration to other Wave businesses requires Wave's approval. Creating the application and testing it against your own account is self-service, but Wave's Permitted Use policy covers any integration that is not direct-to-your-own-business.
Wave serves the US and Canada only, and signup from elsewhere is geo-blocked. The block sticks to the email address on the first failed attempt, so a European team cannot simply retry behind a VPN.
Each connection is tied to one Wave business. Its Business ID is filled in automatically when the consumer picks a single business while authorising; only if Wave returns no business does the consumer need to paste the ID from the business's Wave app URL.
A custom scope list saved in Apideck replaces Wave's defaults: include sales_tax:read/write, estimate:read/write and transaction:write (for expenses), then re-authorise. Without sales_tax:read, invoices and invoice items fail with FORBIDDEN, not only tax rates.
- **partnership required:** false
- **rate limits:** Wave publishes no rate limits; its documented error codes include no throttling or rate-limit code.
- **responsibility matrix:**   - **area:** Create a Wave account
  - **customer:** ✓
  - **apideck:** Docs provided
  - **area:** Register the Wave application
  - **customer:** ✓
  - **area:** Obtain Wave's approval to distribute
  - **customer:** ✓
  - **area:** Add Client ID and Secret to Apideck
  - **customer:** ✓
  - **area:** Maintain the Pro or Advisors subscription
  - **consumer:** ✓
  - **apideck:** Handles the OAuth flow
  - **area:** Authorise the connection
  - **consumer:** ✓ (Business ID is captured automatically; entered by hand only if Wave returns none)
  - **apideck:** ✓ Automatic
  - **area:** Refresh tokens
  - **apideck:** Maintains connector
  - **area:** Build via the Unified API
  - **customer:** ✓
  - **apideck:** Logs & alerts
  - **area:** Monitor connections
  - **consumer:** ✓ Can revoke anytime
  - **customer:** ✓ Via Dashboard
- **sandbox available:** false
- **sandbox note:** Test with a Wave Pro or Advisors business; Wave's authorization screen blocks Starter businesses, even the app owner's own.
- **supported resource categories:**   - **name:** Core Financial
  - **resources:** ledger-accounts
tax-rates
company-info
balance-sheet
profit-and-loss
  - **name:** Accounts Receivable
  - **resources:** invoices
invoice-items
customers
quotes
payments
  - **name:** Accounts Payable
  - **resources:** suppliers
  - **name:** Banking
  - **resources:** bank-accounts
- **webhooks:** Virtual webhooks — created and updated events: customers, suppliers, invoices, invoice items, quotes, tax rates and ledger accounts.

## Supported resources

[Accounting data model](/guides/accounting-data-model.md)

- **custom field support:** true
- **downstream id:** customers
- **downstream name:** Customers
- **id:** customers
- **name:** Customers
- **status:** live
- **custom field support:** true
- **downstream id:** vendors
- **downstream name:** Vendors
- **id:** suppliers
- **name:** Suppliers
- **status:** live
- **custom field support:** true
- **downstream id:** invoices
- **downstream name:** Invoices
- **id:** invoices
- **name:** Invoices
- **status:** live
- **custom field support:** true
- **downstream id:** accounts
- **downstream name:** Accounts
- **id:** ledger-accounts
- **name:** Ledger Accounts
- **status:** live
- **custom field support:** true
- **downstream id:** products
- **downstream name:** Products
- **id:** invoice-items
- **name:** Invoice Items
- **status:** live
- **custom field support:** true
- **downstream id:** sales-taxes
- **downstream name:** Sales Taxes
- **id:** tax-rates
- **name:** Tax Rates
- **status:** live
- **custom field support:** true
- **downstream id:** businesses
- **downstream name:** Businesses
- **id:** company-info
- **name:** Company Info
- **status:** live
- **custom field support:** false
- **downstream id:** balance-sheet
- **downstream name:** Balance Sheet
- **id:** balance-sheet
- **name:** BalanceSheet
- **status:** live
- **custom field support:** false
- **downstream id:** profit-and-loss
- **downstream name:** Profit And Loss
- **id:** profit-and-loss
- **name:** ProfitAndLoss
- **status:** live
- **custom field support:** true
- **downstream id:** bank-accounts
- **downstream name:** Bank Accounts
- **id:** bank-accounts
- **name:** Bank Accounts
- **status:** beta
- **custom field support:** true
- **downstream id:** invoice-payments
- **downstream name:** Invoice Payments
- **id:** payments
- **name:** Payments
- **status:** live
- **custom field support:** true
- **downstream id:** estimates
- **downstream name:** Estimates
- **id:** quotes
- **name:** Quotes
- **status:** beta
- **custom field support:** false
- **downstream id:** money-transactions
- **downstream name:** Money Transactions
- **id:** expenses
- **name:** Expenses
- **status:** live

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/accounting/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/accounting/coverage)
