Skip to main content
GET
/
quickbooks-desktop
/
bills-to-pay
JavaScript
import Conductor from 'conductor-node';

const conductor = new Conductor({
  apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
});

const billsToPays = await conductor.qbd.billsToPay.list({
  vendorId: '80000001-1234567890',
  conductorEndUserId: 'end_usr_1234567abcdefg',
});

console.log(billsToPays.data);
{
  "objectType": "list",
  "url": "/v1/quickbooks-desktop/bills-to-pay",
  "data": [
    {
      "bill": {
        "billId": "123ABC-1234567890",
        "transactionType": "bill",
        "payablesAccount": {
          "id": "80000001-1234567890",
          "fullName": "Accounts-Payable"
        },
        "transactionDate": "2024-10-01",
        "refNumber": "BILL-1234",
        "dueDate": "2024-10-31T00:00:00.000Z",
        "amountDue": "1000.00",
        "currency": {
          "id": "80000001-1234567890",
          "fullName": "USD"
        },
        "exchangeRate": 1.2345,
        "amountDueInHomeCurrency": "1234.56"
      },
      "credit": {
        "creditTransactionId": "123ABC-1234567890",
        "transactionType": "vendor_credit",
        "payablesAccount": {
          "id": "80000001-1234567890",
          "fullName": "Accounts-Payable"
        },
        "transactionDate": "2024-10-01",
        "refNumber": "CREDIT-1234",
        "creditRemaining": "25.11",
        "currency": {
          "id": "80000001-1234567890",
          "fullName": "USD"
        },
        "exchangeRate": 1.2345,
        "creditRemainingInHomeCurrency": "25.11"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.conductor.is/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Headers

​
Conductor-End-User-Id
string
required

The ID of the End-User to receive this request.

Example:

"end_usr_1234567abcdefg"

Query Parameters

​
vendorId
string
required

The vendor whose open bills and available credits should be returned.

Maximum string length: 36
Example:

"80000001-1234567890"

​
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.

Maximum string length: 36
Example:

"80000001-1234567890"

​
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.

Example:

"2025-02-01"

​
currencyIds
string[]

Filter for open bills and available credits in these currencies.

Example:
["80000001-1234567890"]

Response

200 - application/json

Returns open vendor bills and available vendor credits for a specific QuickBooks Desktop vendor.

​
objectType
string
required

The type of object. This value is always "list".

Allowed value: "list"
Example:

"list"

​
url
string
required

The endpoint URL where this list can be accessed.

Example:

"/v1/quickbooks-desktop/bills-to-pay"

​
data
The Bill To Pay object · object[]
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.