Avalara

Avalara Items API

Manage product items and their tax classification

GitHub OpenAPI
Business capability
Indirect Tax Management BC-220.20

Operations 32

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/companies/{companyId}/items List a company's items · Avalara List Items for a Company #
Ask an LLM
“Which products and items are catalogued under my company?”
“Can I filter my company's item list by tax code?”
Tell an agent
List items for company {companyId}.
Show items for company {companyId} matching {filter}.
POST /api/v2/companies/{companyId}/items Add items to a company catalog · Avalara Create Items for a Company #
Ask an LLM
“Can I add products to my company's item catalog?”
“Is it possible to create several items for a company at once?”
Tell an agent
Create items for company {companyId}.
Add new products to the item catalog of company {companyId}.
DELETE /api/v2/companies/{companyId}/items/{itemId}/classifications Remove all classifications from an item · Avalara BatchDeleteItemClassifications #
Ask an LLM
“Can I wipe every classification off an item in one call?”
“What happens to an item's tax rates once all its classifications are cleared?”
Tell an agent destructive · confirm first
Delete all classifications on item {itemId} in company {companyId}.
Clear every tax system code from item {itemId}.
POST /api/v2/companies/{companyId}/items/{itemId}/classifications Add tax system classifications to an item · Avalara CreateItemClassifications #
Ask an LLM
“How do I give an item a product code for another tax system?”
“Can an item hold more than one classification for the same tax system?”
Tell an agent
Add classifications to item {itemId} in company {companyId}.
Attach new tax system product codes to item {itemId}.
GET /api/v2/companies/{companyId}/items/{itemId}/classifications List an item's tax system classifications · Avalara ListItemClassifications #
Ask an LLM
“Which tax system classifications are attached to one of my items?”
“Can I see every product code an item carries across different tax systems?”
Tell an agent
List the classifications on item {itemId} in company {companyId}.
Show every tax system code assigned to item {itemId}.
DELETE /api/v2/companies/{companyId}/items/{itemId}/parameters Remove all parameters from an item · Avalara BatchDeleteItemParameters #
Ask an LLM
“Can I strip every tax-affecting parameter off an item at once?”
“Is there a bulk way to clear an item's default grade and measurement values?”
Tell an agent destructive · confirm first
Delete all parameters on item {itemId} in company {companyId}.
Clear every tax-affecting property from item {itemId}.
POST /api/v2/companies/{companyId}/items/{itemId}/parameters Add tax-affecting parameters to an item · Avalara CreateItemParameters #
Ask an LLM
“How do I record an item's grade or size so it changes the tax it gets?”
“Can I set default parameters on an item instead of on every transaction line?”
Tell an agent
Add parameters to item {itemId} in company {companyId}.
Store new tax-affecting properties on item {itemId}.
GET /api/v2/companies/{companyId}/items/{itemId}/parameters List an item's tax-affecting parameters · Avalara ListItemParameters #
Ask an LLM
“Which tax-affecting properties like grade or measurement are set on an item?”
“What default parameters does an item apply during tax calculation?”
Tell an agent
List the parameters on item {itemId} in company {companyId}.
Show the grade and measurement properties stored for item {itemId}.
POST /api/v2/companies/{companyId}/items/upload Bulk upload items to a company · Avalara BulkUploadItems #
Ask an LLM
“Can I create or update a large batch of items in a single upload?”
“Is there a bulk upload that both adds new items and updates existing ones?”
Tell an agent
Bulk upload items to company {companyId}.
Upload this item list to company {companyId}, creating or updating each one.
POST /api/v2/companies/{companyId}/items/{itemId}/tags Tag an item · Avalara CreateItemTags #
Ask an LLM
“How do I label an item so I can group it with similar products?”
“Can I add several tags to one item at once?”
Tell an agent
Add tags to item {itemId} in company {companyId}.
Label item {itemId} with new grouping tags.
DELETE /api/v2/companies/{companyId}/items/{itemId}/tags Remove all tags from an item · Avalara DeleteItemTags #
Ask an LLM
“Can I clear every tag off an item in one request?”
“Is there a way to drop all the grouping labels on a product?”
Tell an agent destructive · confirm first
Delete all tags on item {itemId} in company {companyId}.
Strip every grouping label from item {itemId}.
GET /api/v2/companies/{companyId}/items/{itemId}/tags List the tags on an item · Avalara GetItemTags #
Ask an LLM
“Which grouping labels are attached to one of my items?”
“Can I see the tags I used to group a particular product?”
Tell an agent
Get the tags on item {itemId} in company {companyId}.
Show the labels attached to item {itemId}.
POST /api/v2/companies/{companyId}/classificationrequests/taxcode Request tax code classification for items · Avalara CreateTaxCodeClassificationRequest #
Ask an LLM
“Can Avalara recommend tax codes for my items if I submit a classification request?”
“How do I ask for my products to be mapped to the right tax codes?”
Tell an agent
Submit a tax code classification request for company {companyId}.
Ask for tax code recommendations on my items in company {companyId}.
GET /api/v2/companies/{companyId}/classificationrequests/taxcode Check status of tax code classification requests · Avalara GetClassificationStatus #
Ask an LLM
“Where can I see whether my tax code classification requests are finished?”
“What status are a company's pending tax code classification requests in?”
Tell an agent
Show the tax code classification request status for company {companyId}.
Check progress of my tax code classification requests in company {companyId}.
DELETE /api/v2/companies/{companyId}/itemcatalogue/{itemCode} Delete a catalogue item by item code · Avalara DeleteCatalogueItem #
Ask an LLM
“Can I delete an item using its item code rather than its numeric ID?”
“Does deleting a catalogue item also remove its classifications and categories?”
Tell an agent destructive · confirm first
Delete catalogue item with code {itemCode} from company {companyId}.
Remove item code {itemCode} and its product categories from the catalogue.
DELETE /api/v2/companies/{companyId}/items/{id} Delete an item by ID · Avalara DeleteItem #
Ask an LLM
“Can I delete an item using its numeric ID?”
“Is removing an item by ID from my company permanent?”
Tell an agent destructive · confirm first
Delete item {id} from company {companyId}.
Remove the item with ID {id}.
GET /api/v2/companies/{companyId}/items/{id} Retrieve one item by ID · Avalara GetItem #
Ask an LLM
“Can I look up a single item by its numeric ID?”
“What tax code and description are stored on one specific item?”
Tell an agent
Get item {id} in company {companyId}.
Show the tax code and description on item {id}.
PUT /api/v2/companies/{companyId}/items/{id} Update an item · Avalara UpdateItem #
Ask an LLM
“How do I change the tax code or description on an existing item?”
“Does updating an item replace the whole record?”
Tell an agent
Update item {id} in company {companyId}.
Replace the record for item {id} with corrected details.
DELETE /api/v2/companies/{companyId}/items/{itemId}/classifications/{id} Delete one item classification · Avalara DeleteItemClassification #
Ask an LLM
“Can I remove just one classification from an item and keep the rest?”
“Is there a way to drop a single tax system code from a product?”
Tell an agent destructive · confirm first
Delete classification {id} of item {itemId} in company {companyId}.
Remove only classification {id} from item {itemId}.
GET /api/v2/companies/{companyId}/items/{itemId}/classifications/{id} Retrieve one item classification · Avalara GetItemClassification #
Ask an LLM
“Can I fetch a single classification of an item by its ID?”
“What product code does one particular item classification hold?”
Tell an agent
Get classification {id} of item {itemId} in company {companyId}.
Show the product code in classification {id} on item {itemId}.
PUT /api/v2/companies/{companyId}/items/{itemId}/classifications/{id} Update an item classification · Avalara UpdateItemClassification #
Ask an LLM
“How do I correct the product code on one classification of an item?”
“Can I change a single classification without touching the item's others?”
Tell an agent
Update classification {id} of item {itemId} in company {companyId}.
Change the product code in classification {id} on item {itemId}.
DELETE /api/v2/companies/{companyId}/items/{itemId}/parameters/{id} Delete one item parameter · Avalara DeleteItemParameter #
Ask an LLM
“Can I remove a single parameter from an item and leave the others?”
“Is there a way to drop just one grade or measurement value from a product?”
Tell an agent destructive · confirm first
Delete parameter {id} of item {itemId} in company {companyId}.
Remove only parameter {id} from item {itemId}.
GET /api/v2/companies/{companyId}/items/{itemId}/parameters/{id} Retrieve one item parameter · Avalara GetItemParameter #
Ask an LLM
“Can I look up a single parameter on an item by its ID?”
“What value does one specific tax-affecting property on an item hold?”
Tell an agent
Get parameter {id} of item {itemId} in company {companyId}.
Show the value of parameter {id} on item {itemId}.
PUT /api/v2/companies/{companyId}/items/{itemId}/parameters/{id} Update one item parameter · Avalara UpdateItemParameter #
Ask an LLM
“How do I change the value of one tax-affecting property on an item?”
“Can I edit a single item parameter without resubmitting all of them?”
Tell an agent
Update parameter {id} of item {itemId} in company {companyId}.
Change the value of parameter {id} on item {itemId}.
DELETE /api/v2/companies/{companyId}/items/{itemId}/tags/{itemTagDetailId} Remove one tag from an item · Avalara DeleteItemTag #
Ask an LLM
“Can I take a single tag off an item and keep its other labels?”
“How do I untag one product from a group?”
Tell an agent destructive · confirm first
Delete tag {itemTagDetailId} from item {itemId} in company {companyId}.
Remove only tag {itemTagDetailId} from item {itemId}.
GET /api/v2/companies/{companyId}/items/{itemCode}/premiumClassification/{systemCode} Get an item's premium classification · Avalara GetPremiumClassification #
Ask an LLM
“Can I retrieve the premium classification for an item code in a given system?”
“What premium classification has an item received for a particular system code?”
Tell an agent
Get the premium classification for item code {itemCode} under system {systemCode} in company {companyId}.
Show premium classification {systemCode} for item code {itemCode}.
GET /api/v2/companies/{companyId}/classificationrequests/taxcode/{requestId}/recommendations Get tax code recommendations for a request · Avalara GetTaxCodeRecommendations #
Ask an LLM
“Which tax codes were recommended for the items in my classification request?”
“Can I see the suggestions that came back from one tax code request?”
Tell an agent
Get tax code recommendations for request {requestId} in company {companyId}.
Show the suggested tax codes from classification request {requestId}.
GET /api/v2/companies/{companyId}/items/{itemCode}/restrictions/import/{countryOfImport} List import restrictions for an item by country · Avalara ListImportRestrictions #
Ask an LLM
“Are there import restrictions on one of my products for a destination country?”
“Can I check what a country restricts before importing a specific item?”
Tell an agent
List import restrictions for item code {itemCode} into {countryOfImport} for company {companyId}.
Check whether {countryOfImport} restricts importing item {itemCode}.
GET /api/v2/items List items across all companies · Avalara QueryItems #
Ask an LLM
“Can I list items from every company in my account at once?”
“Which items exist across all of my companies, not just one?”
Tell an agent
List items across all my companies.
Show every item in the account regardless of company.
GET /api/v2/companies/{companyId}/items/bytags/{tag} Find a company's items by tag · Avalara QueryItemsByTag #
Ask an LLM
“Which of my items carry a particular grouping tag?”
“Can I pull all products in a company that share one label?”
Tell an agent
List items tagged {tag} in company {companyId}.
Find every product labelled {tag}.
POST /api/v2/companies/{companyId}/itemcatalogue Sync an item catalogue with categories · Avalara SyncItemCatalogue #
Ask an LLM
“Can my accounting system sync its whole item catalogue with Avalara?”
“Is there a way to create or update items along with their AvaTax category?”
Tell an agent
Sync the item catalogue for company {companyId}, including AvaTax categories.
Push my catalogue items with their extra properties to company {companyId}.
POST /api/v2/companies/{companyId}/items/sync Sync a large item list without waiting · Avalara SyncItems #
Ask an LLM
“How do I sync a big product list without waiting for each item to be created?”
“What is the per-call limit when syncing items asynchronously?”
Tell an agent
Sync up to 1000 items into company {companyId} in the background.
Queue an asynchronous item sync for company {companyId}, skipping invalid or duplicate items.

Documentation

📖
Documentation
https://developer.avalara.com/api-reference/avatax/rest/v2/
📖
Documentation
https://developer.avalara.com/api-reference/communications/v2/
📖
Documentation
https://developer.avalara.com/api-reference/excise/v1/
📖
Documentation
https://developer.avalara.com/api-reference/item-classification/v2/
📖
Documentation
https://developer.avalara.com/api-reference/avatax-brazil/v1/
📖
Documentation
https://developer.avalara.com/api-reference/vat-reporting/v1/
📖
Documentation
https://developer.avalara.com/api-reference/myLodgeAPI/tax/
📖
Documentation
https://developer.avalara.com/api-reference/CertCapture/v2/
📖
Documentation
https://developer.avalara.com/api-reference/e-invoicing/v1.0
📖
Documentation
https://developer.avalara.com/api-reference/activationService/activationService/
📖
Documentation
https://developer.avalara.com/api-reference/business/v1/
📖
Documentation
https://developer.avalara.com/api-reference/oauth/oauth/
📖
Documentation
https://developer.avalara.com/api-reference/sharedservice/sharedCompanyService/
📖
Documentation
https://developer.avalara.com/api-reference/hscodeclassification/hscodeclassification/
📖
Documentation
https://developer.avalara.com/api-reference/avalara1099/avalara1099/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/avalara/refs/heads/main/openapi/avalara-items-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/avalara/refs/heads/main/asyncapi/avalara-certcapture-sqs-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/avalara:avalara-items-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

avalara-items-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Avalara Items API
  version: '1.0'
  description: 'Operations tagged Items across 2 of this provider''s published API definitions: avalara-avatax-rest-openapi.yml, avatax-apis-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://rest.avatax.com
  description: AvaTax Production
- url: https://sandbox-rest.avatax.com
  description: AvaTax Sandbox
- url: http://{{baseurl}}
tags:


# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/avalara/refs/heads/main/openapi/avalara-items-api-openapi.yml