Supported MethodsSupported Parameters
GET, POST, PATCHid, number, page, pageSize, modTimeStart, modTimeEnd, isDeleted
{
		"ID": "",
		"Number": "",
		"Memo": "",
		"Date": "2022-12-27T21:34:59Z",
		"DueDate": "2022-12-27T21:34:59Z",
		"IsPaid": true,
		"Terms": {
			"FullName": "",
			"ID": ""
		},
		"Vendor": {
			"ID": "",
			"FullName": "",
			"Name": ""
		},
		"APAccount": {
			"ID": "",
			"FullName": ""
		},
		"ItemLines": [{
			"Item": {
				"ID": "",
				"FullName": "",
				"Name": ""
			},
			"SalesTaxCode": {
				"ID": "",
				"FullName": ""
			},
			"Description": "",
			"Quantity": 0.0,
			"Amount": 0.0,
			"Customer": {
				"ID": "",
				"FullName": ""
			},
			"BillableSpecified": true,
			"IsBillable": "",
			"Class": {
				"ID": "",
				"FullName": ""
			},
			"Cost": 0.0,
			"ID": "",
			"SubLines": [{
				"Item": {
					"ID": "",
					"FullName": ""
				},
				"Quantity": 0.0,
				"Amount": 0.0,
				"SalesTaxCode": {
					"ID": "",
					"FullName": ""
				},
				"Desc": "",
				"ID": ""
			}],
			"Account": {
				"Number": "",
				"ID": ""
			},
			"Rate": 0.0,
			"LinkedPurchaseOrder": {
				"Number": ""
			}
		}],
		"AccountLines": [{
			"SalesTaxCode": {
				"ID": "",
				"FullName": ""
			},
			"Account": {
				"ID": "",
				"FullName": ""
			},
			"Amount": 0.0,
			"Memo": "",
			"Customer": {
				"ID": "",
				"FullName": ""
			},
			"BillableSpecified": true,
			"IsBillable": "",
			"Class": {
				"ID": "",
				"FullName": ""
			},
			"ID": ""
		}],
		"LinkedTransactions": [{
			"ID": "",
			"Amount": 0.0,
			"Number": "",
			"Date": "2022-12-27T21:34:59Z",
			"Type": "",
			"LinkType": ""
		}],
		"ExchangeRate": 0.0,
		"CreatedDate": "2022-12-27T21:34:59Z",
		"LastModifiedDate": "2022-12-27T21:34:59Z",
		"DeletedDate": "2022-12-27T21:34:59Z",
		"Balance": 0.0,
		"Currency": {
			"ID": "",
			"FullName": ""
		},
		"AmountInHomeCurrency": 0.0,
		"AmountDue": 0.0,
		"Customer": {
			"Name": ""
		},
		"ShippingAddress": {
			"Name": "",
			"Line1": "",
			"Line2": "",
			"City": "",
			"State": "",
			"PostalCode": "",
			"Country": ""
		},
		"DiscountAmount": 0.0,
		"Account": {
			"Number": "",
			"ID": ""
		},
		"ShippingMethod": {
			"FullName": ""
		}
	}

Important Notes

IsBillable

The bill line items (Expense line or Item Line) has an optional column for customer. IsBillable can only be declared (either true or false -- checked or unchecked) if there is a customer on that line. Through the API and QBD SDK, this option is called BillableSpecified. The QBD UI automatically determines if the Billable state needs to be specified based on the customer column. BillableSpecified is always required (either true or false ).

If BillableSpecified is true, there must be a customer referenced, and IsBillable needs to have either true or false . There are 3 billable states to use:

  • The line (expense or item) does not include a customer so BillableSpecified is false
  • The line includes a customer but is not billable. BillableSpecified is true , there is a customer reference for the line, and IsBillable is false
  • The line includes a customer and is billable. BillableSpecified is true , there is a customer reference for the line, and IsBillable is true

Linked Purchase Order Transactions

  • Supported for QuickBooks Desktop only.
  • Supported for POST only.
  • Do not include ItemLines on the Bill as QuickBooks will use the lines from the linked Purchase Order. If ItemLines are included on the Bill, QuickBooks will duplicate them.