--- title: "List bills and credits available to pay for a vendor" method: GET path: "/quickbooks-desktop/bills-to-pay" --- # List bills and credits available to pay for a vendor `GET /quickbooks-desktop/bills-to-pay` Lists open vendor bills and available vendor credits for a specific QuickBooks Desktop vendor. Use each `bill.billId` as `applyToTransactions[].transactionId` in bill-payment requests. To apply a returned credit, place it under the target bill's `applyToTransactions[].applyCredits[]` entry, set `creditTransactionId` to `credit.creditTransactionId`, and choose an `appliedAmount` that does not exceed `credit.creditRemaining` or the target bill's remaining amount due. **NOTE:** QuickBooks Desktop does not support pagination for bills to pay; hence, there is no `cursor` parameter. Users typically have few bills to pay. ## Query parameters - `vendorId` string, required — The vendor whose open bills and available credits should be returned. - `payablesAccountId` string — Filter for open bills and available credits assigned to this Accounts-Payable account. If omitted, QuickBooks Desktop uses the default A/P account configured in the company file. - `dueDate` string, date — Filter the bill branch to open bills due on or before this date, in ISO 8601 format (YYYY-MM-DD). If omitted, QuickBooks Desktop returns open bills from all due dates. Available credits can still be returned because credits do not have a due date. - `currencyIds` string[] — Filter for open bills and available credits in these currencies. ## Headers - `Conductor-End-User-Id` string, required — The ID of the End-User to receive this request. ## Response `200` Returns open vendor bills and available vendor credits for a specific QuickBooks Desktop vendor. - object - `objectType` 'list', required — The type of object. This value is always `"list"`. - `url` string, required — The endpoint URL where this list can be accessed. - `data` QbdBillToPay[], required — The array of bills-to-pay records. Each record has either a `bill` object or a `credit` object, and the other branch is `null`. - `bill` QbdPayableBill, required - `billId` string, required — The ID of the open bill available to pay. Pass this value as `transactionId` in a bill-payment `applyToTransactions` entry. - `transactionType` 'ar_refund_credit_card' | 'bill' | 'bill_payment_check' | 'bill_payment_credit_card' | 'build_assembly' | 'charge' | 'check' | 'credit_card_charge' | 'credit_card_credit' | 'credit_memo' | 'deposit' | 'estimate' | 'inventory_adjustment' | 'invoice' | 'item_receipt' | 'journal_entry' | 'liability_adjustment' | 'paycheck' | 'payroll_liability_check' | 'purchase_order' | 'receive_payment' | 'sales_order' | 'sales_receipt' | 'sales_tax_payment_check' | 'transfer' | 'vendor_credit' | 'ytd_adjustment' | 'unknown', required — The type of transaction for this payable bill. - `payablesAccount` object, required — The Accounts-Payable (A/P) account to which this payable bill is assigned, used for accounts-payable tracking. **IMPORTANT**: If this payable bill is linked to other transactions, this A/P account must match the `payablesAccount` used in those other transactions. - `id` string, nullable, required — The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types. - `fullName` string, nullable, required — The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive. - `transactionDate` string, date, required — The date of this payable bill, in ISO 8601 format (YYYY-MM-DD). - `refNumber` string, nullable, required — The case-sensitive user-defined reference number for this payable bill, which can be used to identify the transaction in QuickBooks. This value is not required to be unique and can be arbitrarily changed by the QuickBooks user. - `dueDate` string, date, nullable, required — The date by which this payable bill must be paid, in ISO 8601 format (YYYY-MM-DD). - `amountDue` string, required — The amount QuickBooks Desktop reports as due and available to pay for this open bill, represented as a decimal string. Use this value as the candidate `applyToTransactions[].paymentAmount` when creating a bill payment; reduce the payment by any credits you apply. - `currency` object, nullable, required — The payable bill's currency. For built-in currencies, the name and code are standard ISO 4217 international values. For user-defined currencies, all values are editable. - `id` string, nullable, required — The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types. - `fullName` string, nullable, required — The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive. - `exchangeRate` number, nullable, required — The market exchange rate between this payable bill's currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency). - `amountDueInHomeCurrency` string, nullable, required — The monetary amount due for this payable bill converted to the home currency of the QuickBooks company file. Represented as a decimal string. - `credit` QbdApplicableCredit, required - `creditTransactionId` string, required — The ID of the credit transaction available to apply to the vendor's open bills. To apply this credit in a bill-payment request, place it under the target bill's `applyToTransactions[].applyCredits[]` entry and pass this value as `creditTransactionId`. - `transactionType` 'ar_refund_credit_card' | 'bill' | 'bill_payment_check' | 'bill_payment_credit_card' | 'build_assembly' | 'charge' | 'check' | 'credit_card_charge' | 'credit_card_credit' | 'credit_memo' | 'deposit' | 'estimate' | 'inventory_adjustment' | 'invoice' | 'item_receipt' | 'journal_entry' | 'liability_adjustment' | 'paycheck' | 'payroll_liability_check' | 'purchase_order' | 'receive_payment' | 'sales_order' | 'sales_receipt' | 'sales_tax_payment_check' | 'transfer' | 'vendor_credit' | 'ytd_adjustment' | 'unknown', required — The type of transaction for this applicable credit. - `payablesAccount` object, required — The Accounts-Payable (A/P) account to which this applicable credit is assigned, used for accounts-payable tracking. **IMPORTANT**: If this applicable credit is linked to other transactions, this A/P account must match the `payablesAccount` used in those other transactions. - `id` string, nullable, required — The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types. - `fullName` string, nullable, required — The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive. - `transactionDate` string, date, required — The date of this applicable credit, in ISO 8601 format (YYYY-MM-DD). - `refNumber` string, nullable, required — The case-sensitive user-defined reference number for this applicable credit, which can be used to identify the transaction in QuickBooks. This value is not required to be unique and can be arbitrarily changed by the QuickBooks user. - `creditRemaining` string, required — The remaining vendor credit available to apply to open bills, represented as a decimal string. When applying this credit to a bill-payment request, choose an `applyToTransactions[].applyCredits[].appliedAmount` that does not exceed this value or the target bill's remaining amount due. - `currency` object, nullable, required — The applicable credit's currency. For built-in currencies, the name and code are standard ISO 4217 international values. For user-defined currencies, all values are editable. - `id` string, nullable, required — The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types. - `fullName` string, nullable, required — The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive. - `exchangeRate` number, nullable, required — The market exchange rate between this applicable credit's currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency). - `creditRemainingInHomeCurrency` string, nullable, required — The remaining balance of this applicable credit converted to the home currency of the QuickBooks company file. Represented as a decimal string. --- [API](https://skmtc.net/conductor-is/apis/conductor-api.md) · [All operations](https://skmtc.net/conductor-is/apis/conductor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductor-is/conductor-api/revisions/0b07b3ebe160/schema)