Inventory Items
Retrieve an inventory item
QuickBooks Desktop API
Core Resources
- Auth Sessions
- End Users
Utilities
Transactions
- All Transactions
- Bill Check Payments
- Bill Credit Card Payments
- Bills
- Checks
- Credit Card Charges
- Credit Card Credits
- Credit Memos
- Estimates
- Inventory Adjustments
- Invoices
- Item Receipts
- Journal Entries
- Purchase Orders
- Receive-Payments
- Sales Orders
- Sales Receipts
- Time Tracking Activities
- Transfers
- Vendor Credits
General
- Account Tax Lines
- Accounts
- Classes
- Company
- Customers / Jobs
- Date-Driven Terms
- Employees
- Inventory Sites
- Payment Methods
- Payroll Wage Items
- Preferences
- Price Levels
- Sales Representatives
- Sales-Tax Codes
- Standard Terms
- Vendors
Items
- Discount Items
- Inventory Assembly Items
- Inventory Items
- Item Groups
- Item Sites
- Non-Inventory Items
- Sales-Tax Items
- Service Items
- Subtotal Items
Inventory Items
Retrieve an inventory item
Retrieves an inventory item by ID.
GET
/
quickbooks-desktop
/
inventory-items
/
{id}
import Conductor from 'conductor-node';
const client = new Conductor({
apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
});
async function main() {
const inventoryItem = await client.qbd.inventoryItems.retrieve('80000001-1234567890', {
conductorEndUserId: 'end_usr_1234567abcdefg',
});
console.log(inventoryItem.id);
}
main();
{
"id": "80000001-1234567890",
"objectType": "qbd_inventory_item",
"createdAt": "2021-10-01T17:34:56.000Z",
"updatedAt": "2021-10-01T20:45:30.000Z",
"revisionNumber": "1721172183",
"name": "Cabinet",
"fullName": "Products:Electronics:Widgets",
"barcode": "012345678905",
"isActive": true,
"class": {
"id": "80000001-1234567890",
"fullName": "Furniture"
},
"parent": {
"id": "80000001-1234567890",
"fullName": "Kitchen"
},
"sublevel": 1,
"sku": "MPN-123456",
"unitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Weight Units"
},
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"salesDescription": "High-quality steel bolts suitable for construction",
"salesPrice": "19.99",
"incomeAccount": {
"id": "80000001-1234567890",
"fullName": "Income:Product Sales"
},
"purchaseDescription": "Bulk purchase of steel bolts for inventory",
"purchaseCost": "15.75",
"purchaseTaxCode": {
"id": "80000001-1234567890",
"fullName": "GST"
},
"cogsAccount": {
"id": "80000001-1234567890",
"fullName": "Expenses:COGS"
},
"preferredVendor": {
"id": "80000001-1234567890",
"fullName": "Acme Supplies Ltd."
},
"assetAccount": {
"id": "80000001-1234567890",
"fullName": "Assets:Inventory"
},
"reorderPoint": 50,
"maximumQuantityOnHand": 200,
"quantityOnHand": 150,
"averageCost": "16.50",
"quantityOnPurchaseOrder": 10,
"quantityOnSalesOrder": 10,
"externalId": "12345678-abcd-1234-abcd-1234567890ab",
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}
Authorizations
Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}"
).
Headers
The ID of the EndUser to receive this request (e.g., "Conductor-End-User-Id: {{END_USER_ID}}"
).
Example:
"end_usr_1234567abcdefg"
Path Parameters
The QuickBooks-assigned unique identifier of the inventory item to retrieve.
Example:
"80000001-1234567890"
Response
200 - application/json
Returns the specified inventory item.
The response is of type object
.
import Conductor from 'conductor-node';
const client = new Conductor({
apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
});
async function main() {
const inventoryItem = await client.qbd.inventoryItems.retrieve('80000001-1234567890', {
conductorEndUserId: 'end_usr_1234567abcdefg',
});
console.log(inventoryItem.id);
}
main();
{
"id": "80000001-1234567890",
"objectType": "qbd_inventory_item",
"createdAt": "2021-10-01T17:34:56.000Z",
"updatedAt": "2021-10-01T20:45:30.000Z",
"revisionNumber": "1721172183",
"name": "Cabinet",
"fullName": "Products:Electronics:Widgets",
"barcode": "012345678905",
"isActive": true,
"class": {
"id": "80000001-1234567890",
"fullName": "Furniture"
},
"parent": {
"id": "80000001-1234567890",
"fullName": "Kitchen"
},
"sublevel": 1,
"sku": "MPN-123456",
"unitOfMeasureSet": {
"id": "80000001-1234567890",
"fullName": "Weight Units"
},
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"salesDescription": "High-quality steel bolts suitable for construction",
"salesPrice": "19.99",
"incomeAccount": {
"id": "80000001-1234567890",
"fullName": "Income:Product Sales"
},
"purchaseDescription": "Bulk purchase of steel bolts for inventory",
"purchaseCost": "15.75",
"purchaseTaxCode": {
"id": "80000001-1234567890",
"fullName": "GST"
},
"cogsAccount": {
"id": "80000001-1234567890",
"fullName": "Expenses:COGS"
},
"preferredVendor": {
"id": "80000001-1234567890",
"fullName": "Acme Supplies Ltd."
},
"assetAccount": {
"id": "80000001-1234567890",
"fullName": "Assets:Inventory"
},
"reorderPoint": 50,
"maximumQuantityOnHand": 200,
"quantityOnHand": 150,
"averageCost": "16.50",
"quantityOnPurchaseOrder": 10,
"quantityOnSalesOrder": 10,
"externalId": "12345678-abcd-1234-abcd-1234567890ab",
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}