SDKs

Four official SDKs, generated from the same OpenAPI document as the API reference and released together with the API:

Language	Package	Install	Requires
TypeScript / Node.js	@desktopaccountingapi/quickbooks-desktop	npm install @desktopaccountingapi/quickbooks-desktop	Node.js 20
Python	desktopaccountingapi-quickbooks-desktop	pip install desktopaccountingapi-quickbooks-desktop	Python 3.9
C# / .NET	DesktopAccountingAPI.QuickBooksDesktop	dotnet add package DesktopAccountingAPI.QuickBooksDesktop	.NET 8 or .NET Standard 2.0
Java	com.desktopaccountingapi:quickbooks-desktop	Maven or Gradle	Java 11

What every SDK does for you

The SDKs are thin over the REST API, but they implement the rules that are easy to get wrong by hand:

• Same resource tree in every language. client.qbd.invoices.list(...), client.endUsers.create(...), client.requests.retrieve(...), with each language’s naming style. Method names follow the operation IDs in the reference.
• End-user scoping. Pass the end user per call, or create a scoped client with forEndUser("eu_...").
• Idempotency keys. Every write gets an Idempotency-Key, reused across that write’s retries.
• Safe retries. Network errors before a response, 429, and 5xx responses marked retryable are retried with exponential backoff (0.5 to 8 seconds, honoring Retry-After), two retries by default. A response with outcome pending or unknown is never retried.
• Pending requests. When a sync call times out after QuickBooks received it (504 QBD_REQUEST_TIMEOUT), the SDK waits for the result through the request resource instead of resending.
• Typed errors. One error class per error type, with every field (code, userFacingMessage, requestId, retryable, outcome, fixes) available directly.
• Auto-pagination that requests the next page only when your loop needs it (a loop that stops early runs no extra QuickBooks query), reads ahead for slow loops to stay within QuickBooks’ cursor window, a page-by-page mode, and a typed cursor-expired error that never restarts silently.
• Exact money. Amounts are decimal types in Python (Decimal), C# (decimal) and Java (BigDecimal), and decimal strings in TypeScript.
• Key checks. A mistyped key fails locally, before a network call, thanks to the checksum in every secret key.
• Webhook verification helpers for signed webhooks.

Configuration

Option	Environment variable	Default
API key	DAAPI_SECRET_KEY	none
Base URL	DAAPI_BASE_URL	https://api.desktopaccountingapi.com (a trailing /v1 is accepted)
Timeout		100 seconds per HTTP attempt (the server’s 90-second default plus 10)
Total timeout		none; caps a whole call, retries and waiting included
Max retries		2
Default headers		none
End user		none; set per call or with forEndUser

Porting from Conductor

Code written for Conductor’s Node.js and Python SDKs runs on ours with two edits, the import and the API key: the resource tree, parameter names and response fields match, and the TypeScript and Python SDKs accept Conductor’s conductorEndUserId / conductor_end_user_id, client option names and error class names. Each SDK page has a “Porting from Conductor” section, and Migrating from Conductor lists the API-level differences.

Other languages

Any language with an HTTP client works with the REST API. You can also generate a client from the OpenAPI document. Generated clients do not implement the retry, idempotency and pagination rules above, so follow Idempotency and Pagination when you write your own.