# QuickBooks Item API

**Canonical:** https://apis.io/apis/quickbooks/quickbooks-item-api/  
**Provider:** QuickBooks — https://apis.io/providers/quickbooks/  
**Base URL:** https://quickbooks.api.intuit.com  
**Documentation:** https://developer.intuit.com/app/developer/qbo/docs/develop

QuickBooks Item API is one of 82 APIs that [QuickBooks](https://apis.io/providers/quickbooks/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 12 JSON Schema definitions. Tagged areas include Item. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, an AsyncAPI specification, and 12 JSON Schemas.

An item is a thing that your company buys, sells, or re-sells, such as products and services. An item is shown as a line on an invoice or other sales form. The Item.Type attribute, which specifies how the item is used, has one of the following values: Inventory Used in transactions to track merchandise that your business purchases, stocks, and re-sells as inventory. QuickBooks tracks the current number of inventory items in stock, cost of goods sold, and the asset value of the inventory after the purchase and sale of every item. Group Used as a container for a bundle of items with a count for each item. For example, a Gift Basket with 2 apples, 5 pencils and 1 stack of paper. The bundle is the Gift Basket, the bundle items are apples, pencils and paper. Note: Creating them via the QuickBooks Online API is not supported. Bundles cannot contain other bundles. Bundles cannot contain categories. An item can be listed more than once with same or different quantities. Bundles can be added to transactions. Service Used in transactions to track services that you charge on the purchase. For example, specialized labor, consulting hours, and professional fees. NonInventory Used for goods you buy but don’t track, like office supplies. Used in transactions for goods and materials for a specific job that you charge back to the customer and don't track yourself. In addition to the above, QuickBooks companies supports item categories to define item hierarchies. Use Item.Type set to Category to create hierarchies. Of note: Non-category items used as parent items and used for things the company sells cannot be freely mixed. An app can now clearly distinguish between things the company sells and categories used to build a hierarchy to organize them. Categories do not have a price, income account, or expense accounts. Items—-the things the company sells—-cannot have children. That is, if your items are organized into a hierarchy, items can only be at the leaf level of the hierarchy. Categories are only available on companies that have enabled Categories. Test the CompanyInfo.NameValue.Name.ItemCategoriesFeature flag:true— categories are enabled false— categories are not enabled.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/v3/company/{realmID}/query` | Query an entity with a SELECT statement |
| POST | `/v3/company/{realmID}/item` | Create an item / Create a category / Full update an item / Update a category |
| GET | `/v3/company/{realmID}/item/{itemId}` | Read a bundle / Read a category / Read an item |

## Machine-readable artifacts (23)

- **OpenAPI** — https://artifacts.apis.io/quickbooks/openapi/quickbooks-item-api-openapi.yml
- **Documentation** — https://developer.intuit.com/app/developer/qbo/docs/develop
- **APIReference** — https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/account
- **GettingStarted** — https://developer.intuit.com/app/developer/qbo/docs/get-started
- **Authentication** — https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0
- **AsyncAPI** — https://artifacts.apis.io/quickbooks/asyncapi/quickbooks-online-webhooks-asyncapi.yml
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-invoiceresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-salesreceiptresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-estimateresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-refundreceiptresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-customerresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-creditmemoresponse-schema.json
- **Documentation** — https://developer.intuit.com/app/developer/qbpayments/docs/develop
- **APIReference** — https://developer.intuit.com/app/developer/qbpayments/docs/api/resources/all-entities/charges
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-chargeresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-card-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-bankaccount-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-echeckresponse-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-chargerequest-schema.json
- **JSONSchema** — https://artifacts.apis.io/quickbooks/json-schema/quickbooks-bankaccountrequest-schema.json
- **Documentation** — https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/account
- **Sandbox** — https://sandbox-quickbooks.api.intuit.com/v3/company/{realmId}
- **API Explorer** — https://developer.intuit.com/app/developer/qbo/docs/api/accounting/most-commonly-used/account

## Other QuickBooks APIs (12)

- [QuickBooks Online GraphQL API](https://apis.io/apis/quickbooks/graphql/)
- [QuickBooks Workforce Payroll API](https://apis.io/apis/quickbooks/payroll/)
- [QuickBooks Account API](https://apis.io/apis/quickbooks/quickbooks-account-api/)
- [QuickBooks Account List Detail API](https://apis.io/apis/quickbooks/quickbooks-accountlistdetail-api/)
- [QuickBooks AP Aging Detail API](https://apis.io/apis/quickbooks/quickbooks-apagingdetail-api/)
- [QuickBooks AP Aging Summary API](https://apis.io/apis/quickbooks/quickbooks-apagingsummary-api/)
- [QuickBooks AR Aging Detail API](https://apis.io/apis/quickbooks/quickbooks-aragingdetail-api/)
- [QuickBooks AR Aging Summary API](https://apis.io/apis/quickbooks/quickbooks-aragingsummary-api/)
- [QuickBooks Attachable API](https://apis.io/apis/quickbooks/quickbooks-attachable-api/)
- [QuickBooks Balance Sheet API](https://apis.io/apis/quickbooks/quickbooks-balancesheet-api/)
- [QuickBooks Batch API](https://apis.io/apis/quickbooks/quickbooks-batch-api/)
- [QuickBooks Bill API](https://apis.io/apis/quickbooks/quickbooks-bill-api/)

## Tags

Item

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/quickbooks/quickbooks-item-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/quickbooks/.