Skip to main content
Avalara Help Center

Product and service attribute guidelines

This article applies to:AvaTax

To calculate taxes other than sales and use tax, Avalara may require additional information about the products or services that you sell. You send this information with your transactions as attributes. Different jurisdictions require different attributes to calculate taxes accurately, so it's best practice to send all of the attributes that apply to your products or services.

See the AvaTax API documentation for additional information on how to include attributes with your transactions. Note that these attributes are referred to as 'parameters' in the API documentation. Use the ListParameters API endpoint to retrieve this full list of attributes, or the ListParametersByItem API endpoint to find attributes that you have mapped to an item code.

Attribute definitions and options

Name Data type What it means Attribute type Possible values
Alcohol Content Numeric Ratio Alcohol percentage by volume Product Percentage, as a number.
For example, use 10 for 10%.
Alcohol Route Type Enumeration Used to indicate the sales channel for a beverage alcohol transaction. Transaction

Select one of the following:

  • 3T
  • DTC
  • DTT
  • Pickup
Average Daily Rate Numeric Currency Specific to Santa Monica, California; the average daily rate is a category assigned by the tax authority to the business based on previous years activity. This category determines the taxation rate. Company Dollar amount, as a number
Beverage Container Material Enumeration Specify the material that beverage containers are made of. Used for calculating bottle deposit fees. Product

Select one of the following:

  • Glass
  • Metal
  • Other - Not Plastic
  • Paperboard
  • Plastic #1 (PET)
  • Plastic #2 (HDPE)
  • Plastic - Other
Bill To DOB String This parameter is relevant to businesses conducting direct shipments of alcohol to consumers and used to capture the date of birth (DOB) associated with the "Bill To" recipient. Date of birth (DOB) must be formatted as YYYY-MM-DD.  Transaction A date in the format YYYY-MM-DD
Brand String Brand name associated with the product being sold.  Product A text string
Cellular Capability Boolean Can the item in question connect to a cellular communications network? Product

Select one of the following:

  • True
  • False
Container Size Numeric Measured Intended for use where tax rate is dependent on size of container. Product Volume of the contained, as a number
Contains Mercury Boolean Whether or not the product contains mercury. Product

Select one of the following:

  • True
  • False
Digital Boolean Is the physical item in question built on digital technology, vs analog. Product

Select one of the following:

  • True
  • False
Discount Type Enumeration Covers scenarios where a tax is discounted (not fully exempt), based on the status of the purchaser or seller (such as Senior Citizens). Transaction

Select one of the following:

  • Active Duty Military
  • Charity Event
  • Child
  • Senior Citizen
  • Junior
Disposable Boolean Is the item in question single-use or limited-use vs built for intended extended use. Product

Select one of the following:

  • True
  • False
Establishment Type Enumeration A categorization of different types of lodging establishments or venue properties; the implications of these categories can vary by jurisdiction. Location

Select one of the following:

  • Shared Housing Unit
  • Vacation Rental
  • AllInclusive
  • Guest House
  • Hotel with Casino
  • Hotel
  • Motel
  • Paradores
  • BedAndBreakfast
  • ShortTermRental
  • CountryInn
  • QualifyingBungalow
  • QualifyingNonHousekeepingCottage
  • QualifyingHousekeepingCottage
  • QualifiedPrivateResidentialProperty
  • TouristHome
  • GroupHotel
  • AccommodationsBroker
  • Homestead
  • Inn
  • HistoricHotel
  • LodgingHouse
  • Resort
  • LargeHotel
  • PrivateResidence
  • Hostel
  • Cabin
  • Zone A
  • Zone B
  • Zone C
  • Zone D
  • Zone E
  • Zone F
  • RV
Exempt Entity Performance Boolean Whether a performance or artistic production is performed and produced for the benefit of a qualifying exempt entity. Product

Select one of the following:

  • True
  • False
First Use Boolean An indication if the item in question is being transacted before it's first end consumer use since original manufacture; pertinent to reusable items or items with sold as pre-owned. Product

Select one of the following:

  • True
  • False
Food Preparation Enumeration Indicates method of food preparation for service to customers. Product

Select one of the following:

  • Heated
  • Unheated
  • SlicedOrCut
  • Poured
  • Served
  • IngredientsCombined
  • HandDipped
Food And Beverage Sales Numeric Currency Food and beverage sales amount where relevant to taxability or tax rate.   Company Dollar amount, as a number
Home Consumption Boolean The item in question is intended for home consumption. Product

Select one of the following:

  • True
  • False
Instate Pro Team Boolean At a sporting event, whether one of the teams is an in-state professional sports team. Transaction

Select one of the following:

  • True
  • False
Is Accelerated Tax Paid  Boolean Indicates that tax is not due on the rental or lease payment because the tax was paid upfront on the aggregate lease or rental payments. Transaction

Select one of the following:

  • True
  • False
Is Alcohol Sample Boolean Used when a beverage alcohol product is a sample product.  Product

Select one of the following:

  • True
  • False
Is Certified Extended Stay Boolean An indication that the lodging stay in question qualifies as a certified extended stay (an exemption that exists in some cases for stays exceeding 30 days); applicability and qualifications can vary by jurisdiction. Product

Select one of the following:

  • True
  • False
Is Direct Alcohol Import Boolean Used when a beverage alcohol product is a direct import product. Transaction

Select one of the following:

  • True
  • False
Is Entire House Rented Boolean Specifies whether this lodging establishment is rented in whole, or par; typically referring to scenarios where the property in question is an individual residence or estate, and whether rooms are rented vs the entire building. The definition of house can vary by jurisdiction. Location

Select one of the following:

  • True
  • False
Is Foreign Alcohol Boolean Used when a beverage alcohol product is a foreign beverage alcohol product. Product

Select one of the following:

  • True
  • False
Is Full Service Boolean Full Service is needed for rules in California that are based on definitions from Smith Travel Research.  Use of the term Full Service has appeared in other jurisdictions as well, and the meaning is jurisdiction specific. Company

Select one of the following:

  • True
  • False
Is Heavy Machinery Boolean Indicates the product leased or rented is heavy equipment.  Transaction

Select one of the following:

  • True
  • False
Is Incidental to Owner Use Boolean An indication if this establishment or property is use infrequently enough for lodging that it is considered only "incidental" compared to the owners use. The definition of incidental can vary by jurisdiction. Location

Select one of the following:

  • True
  • False
Is Indeterminate Length Boolean Indicates that a lease or rental of property is for an indeterminate period of time.  Transaction

Select one of the following:

  • True
  • False
Is Intercompany Boolean Indicates whether the equipment is leased or rented to a parent, subsidiary, or sister corporations. Transaction

Select one of the following:

  • True
  • False
Is Limited Service Boolean Limited Service is needed for rules in California that are based on definitions from Smith Travel Research. Use of the term Limited Service has appeared in other jurisdictions as well, and the meaning is jurisdiction specific. Company

Select one of the following:

  • True
  • False
Is Operator Provided Boolean Indicates whether leased equipment is provided with an operator.  Transaction

Select one of the following:

  • True
  • False
Is Owner's Primary Address Boolean An indication if this establishment or property is considered the Owners primary residence. The determination of ownership and primary residence can vary by jurisdiction. Location

Select one of the following:

  • True
  • False
Is Reseller Boolean An indication of whether the item being transacted in is being sold/rented in a reseller capacity. Generally a reseller is a third party or platform that does not own the item being transacted, though this definition varies by jurisdiction and the goods in question (lodging, equipment, services, etc). Reselling typically requires authorization or certification for tax purposes. Location

Select one of the following:

  • True
  • False
Is Residence Owner Present Boolean Whether or not the owner of a residence is present for a transaction. Primarily used in the short-term lodging context. Transaction

Select one of the following:

  • True
  • False
Is Service Contract Boolean This parameter is used to distinguish between a service contract and rental contract. A contract is for service if the equipment owner is hired to do a specific job; maintains complete control over the equipment; and retains discretion how and when to perform the job. Transaction

Select one of the following:

  • True
  • False
Is Short Term Boolean An indication if this lodging service qualifies as "short term"; the definition of which can vary by jurisdiction. Location

Select one of the following:

  • True
  • False
Is Start-Up Boolean Use when company is within the jurisdiction's definition of start-up, if applicable to taxability or rate. Company

Select one of the following:

  • True
  • False
IsTaxableService Boolean This parameter is used in Connecticut to distinguish between a service contract for a taxable service and a service contract for a nontaxable service.  This parameter is used in conjunction with the IsServiceContract parameter.  Transaction

Select one of the following:

  • True
  • False
Item Grade Enumeration Is this item marketed, packaged, or sold for use in industrial, commercial, consumer, or professional settings. Product

Select one of the following:

  • Professional
  • Industrial
  • Commercial
  • Consumer
Lodging Marketplace Boolean Applies to businesses that are online lodging marketplaces or platforms. Product

Select one of the following:

  • True
  • False
Net Length Numeric Measured The length (measurement technique context dependent, fully unwound and extended; e.g. cordage) of only the item, substance, or product in question, exclusive of packaging, container, or other ancillary materials. Product Length, as a number
Net Surface Area Numeric Measured The surface area (one sided, fully unfolded and extended, e.g. yardage of cloth) of only the item, substance, or product in question, exclusive of packaging, container, or other ancillary materials. Product Area, as a number
Net Volume Numeric Measured The volume of only the item, substance, or product in question, exclusive of packaging, container, or other ancillary materials. Product Volume, as a number
Net Weight Numeric Measured The weight (mass) of only the item, substance, or product in question, exclusive of packaging, container, or other ancillary materials. Product Weight, as a number
Number of Bedrooms in Unit Numeric Measured Indicates the number of designated bedrooms in the accommodations unit in question. Product A number
Number of Beds Numeric Measured Indicates the number of beds in the accommodations unit in question. Product A number
Number Of Days Numeric Measured The number of days a product is rented or leased.  Transaction A number
Number of Nights Numeric Measured A count of overnight stays in relation to accommodations. Product A number
Number of Rooms in Unit Numeric Measured A count of the number of rooms in the accommodations, subject to varying jurisdictional interpretation. Product A number
Number of Sleeping Rooms Numeric Measured Indicates the number of rooms, intended for sleeping, in the accommodations unit in question. Product A number
Number of Units for Rent Numeric Measured A count of the number of units available in a lodging establishment, subject to varying jurisdictional interpretation. Location A number
Pack Size Numeric Measured Allows customer to specify, where relevant, the number of taxable items in a package, such as cigarettes in a pack or bottles in a case. Product A number
PerformanceType Enumeration Describes characteristics of a performance. Transaction

Select one of the following:

  • Live
  • LiveRetransmission
Place of Consumption Enumeration Indicates intended point of consumption of prepared food relative to a seller establishment. Product

Select one of the following:

  • OnPremise
  • OffPremise
Preferred Program Enumeration Indicates which Preferred Program, if any, this item qualifies for in relation to customs duties. Transaction

Select one of the following:

  • NAFTA
Pre-packaging Enumeration A classification of the packaging used for prepared foods. Product

Select one of the following:

  • FactorySealed
  • Closed
  • Open
  • SellerPackaged
  • Fountain
Prepared Food Threshold Boolean An indication of whether the seller threshold for gross receipts of prepared food has been met; definition can vary by jurisdiction. Location

Select one of the following:

  • True
  • False
Prepared Food Threshold Met Boolean An indication of whether the seller threshold for gross receipts of prepared food has been met; definition can vary by jurisdiction. Location

Select one of the following:

  • True
  • False
QualifiedTenancy Boolean   Transaction

Select one of the following:

  • True
  • False
Quantity Numeric Measured Transaction A number
Revenue per Available Room Numeric Currency Specific to Santa Cruz County, California.  RevPAR is a category assigned by the tax authority to the business based on revenue per available room.   Company Dollar amount, as a number
Revenue Requirement Met Boolean Revenue Requirement Must be Met Before Tax Applies.  (See local jurisdiction for threshold) Company

Select one of the following:

  • True
  • False
Rim Diameter Numeric Measured The measure of a tire's rim diameter. Determines the rim onto which a tire can be mounted. Product Length, as a number
Screen Size Numeric Measured A diagonal length measure of a rectangular screen along it's surface; indicative of it's total surface area. Product Length, as a number
Seller Classification Enumeration A classification (using NAICS) of the seller involved in the item transaction. Product

Select one of the following:

  • Cafe
  • Bar
  • Club
  • InStateDirectShipper
  • OutOfStateDirectShipper
  • Restaurant
  • GroceryStore
  • ArtisanBakery
  • Hotel
  • ConvenienceStore
  • Caterer
  • FoodManufactuter
  • Cafeteria
  • LunchCounter
  • BoardingHouse
  • CarryOutShop
Ship To DOB String This parameter is relevant to businesses conducting direct shipments of alcohol to consumers and used to capture the date of birth (DOB) associated with the "Ship To" recipient. Date of birth (DOB) must be formatted as YYYY-MM-DD.  Transaction A date in the format YYYY-MM-DD
Short Term Rental Type Enumeration Types of short-term rental for Community Impact Fee in Massachusetts Company

Select one of the following:

  • ProfessionallyManaged
  • MultiFamilyDwelling
  • Standard
Sleeps Numeric Measured Indicates the maximum number of sleeping people the accommodations in question are authorized to support. Product A number
Sold as Part of a Meal Boolean Indicates that this item is sold with other items as part of a meal. Product

Select one of the following:

  • True
  • False
Sporting Event Type Enumeration Identifies what sport is being conducted or by what sporting organization Transaction

Select one of the following:

  • Boxing
  • Greyhound Racing
  • Motorsports
  • Mixed Martial Arts
  • NASCAR
  • Single Discipline Martial Arts
  • Wrestling - Entertainment
  • Wrestling - Sport
  • Mini-Golf
Studded Boolean Used for studded tires where necessary to taxability. Product

Select one of the following:

  • True
  • False
Tire Type Enumeration Defines the type of tire being sold Product

Select one of the following:

  • New
  • Retread
  • Used Import
  • Used
Tracking Number String Tracking number associated with a direct alcohol shipment. When multiple tracking numbers apply to a shipment, they must be separated by a semicolon (;).  Transaction A text string
Tread Width Numeric Measured The measurement between the outboard and inboard edges of a tire's tread design. Product Length, as a number
Utensils Enumeration Indicates availability of utensils with prepared food as part of a sale. Product

Select one of the following:

  • SoldWithUtensils
  • NoUtensils
  • UtensilsAvailable
Venue Has Liquor License Boolean Whether or not the venue for a performance or amusement has a liquor license. Transaction

Select one of the following:

  • True
  • False
Venue Size Numeric Measured Maximum capacity of an entertainment venue to which tickets are sold Product  
Venue Special License Enumeration Whether a location has any special licenses that affect taxability of transactions tied to that location. Product

Select one of the following:

  • Liquor License
  • NV Nonrestricted Gaming
  • NV Restricted Gaming
Venue Type Enumeration Categorization of venue types, generally relevant to admissions taxes. Definitions and implications may vary between jurisdictions. Transaction

Select one of the following:

  • Garden
  • Movie Theater
  • MunicipalOwned
  • Museum
  • Stadium
  • Zoo
  • Campground
  • Exhibition Hall
  • Indoor
  • Outdoor
  • Swimming Pool
Voltage Numeric Measured Voltage capacity for retail purposes (e.g. "12 volt battery") Product A number
Working Unit Code String   Transaction A text string
Written Agreement with Notice Boolean   Product

Select one of the following:

  • True
  • False