Get QBO transactions in internal format (Cron-Ready)
Retrieve QuickBooks Online transactions transformed to match internal Transaction schema with clean references to database objects.
**Perfect for Cron Jobs & Sync Setup:**
- Returns transactions with actual database IDs for ledger accounts and bank accounts when they exist
- Clearly indicates which accounts/transactions need creation (needsCreation: true, exists: false)
- Follows same structure as syncAccountingData.ts for consistency
- Compatible with createTransaction.ts and addBankAccount.ts creation patterns
- Supports incremental sync with isNew/isUpdated flags and syncOnly parameter
**Response includes:**
- Ledger account IDs and full details (or indicates needs creation)
- Bank account (PlaidAccount) references and IDs when applicable
- QBO account IDs for mapping and creation
- Transaction status (new/updated/existing)
Use `syncOnly=true` to get only new/updated transactions for incremental syncs.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>
, where token is your auth token.
Query parameters
entityId
Entity ID
enrichWithContacts
Include contact information
groupPairs
Group transactions as debit/credit pairs
syncOnly
Set to ‘true’ to return only new/updated transactions for incremental cron sync (filters where isNew=true or isUpdated=true)
Allowed values:
Response
Transactions in internal format
success
data
meta