# GetSyncTaxCodeRecommendations

Get the real-time tax code recommendations for the specified items without saving item data.

`POST /api/v2/companies/{companyId}/$taxcode-recommendations`

**API:** AvaTax API
**Tag:** Items
**API Version:** v2
**Base URL:** https://sandbox-rest.avatax.com/
**Content-Type:** `application/json`
**Accepts:** `application/json`
**Authentication:** API Key (`Authorization` in header) or OAuth 2.0 or Basic (username + license key)

Source: https://developer.avalara.com/products/crossborder/api/methods/Items/GetSyncTaxCodeRecommendations/

## Description

Provides immediate tax code recommendations for item details submitted in the request. Item data is processed only for recommendation purposes and is not persisted.
            
Maximum items per request: 50 (subject to change).

### Security Policies

* This API requires one of the following user roles: AccountAdmin, AccountOperator, AccountUser, AvaTaxOnlyAccountAdmin, AvaTaxOnlyAccountUser, AvaTaxOnlyCompanyAdmin, AvaTaxOnlyCompanyUser, BatchServiceAdmin, CompanyAdmin, CompanyUser, CSPAdmin, CSPTester, ReturnsOnlyAccountAdmin, ReturnsOnlyAccountUser, ReturnsOnlyCompanyAdmin, ReturnsOnlyCompanyUser, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin, TechnicalSupportUser.

## Parameters

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `companyId` | integer | path | Yes | The unique ID of the company. |
| `X-Avalara-Client` | string | header | No | Identifies the software you are using to call this API.  For more information on the client header, see [Client Headers](https://developer.avalara.com/avatax/client-headers/) . |

## Request Body

**Schema:** `ItemTaxcodeRecommendationBatchesInputModel[]`

Represents an input model of a single item for tax code recommendation batches (both synchronous and asynchronous).

| Property | Type | Required | Description |
|---|---|---|---|
| `description` | string | **Yes** | A brief description of the item. Example: `Ceramic Mug`. |
| `category` | string | No | The category of the item.
For example: "Home > Kitchen > Mugs" Example: `Home > Kitchen > Mugs`. |
| `itemType` | string | No | The type of item. (optional)
Examples: "Physical", "Digital", "Service", "Freight" Example: `Physical`. |
| `upc` | string | No | The Universal Product Code (UPC) associated with the item. (optional) Example: `123456789012`. |
| `summary` | string | No | A summary or detailed description of the item. (optional) Example: `A beautiful ceramic mug for hot beverages`. |

## Responses

| Status | Description | Schema |
|---|---|---|
| 200 | Success |  |
| 400 | Bad Request | `ProblemDetails` |
| 401 | Unauthorized | `ProblemDetails` |
| 404 | Not Found | `ProblemDetails` |
| 500 | Server Error |  |
| 504 | Server Error |  |

## Example Request

```bash
curl -X POST "https://sandbox-rest.avatax.com/api/v2/companies/{companyId}/$taxcode-recommendations" \
  -H "Authorization: Basic <credentials>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '[
  {
    "description": "Ceramic Mug",
    "category": "Home > Kitchen > Mugs",
    "itemType": "Physical",
    "upc": "123456789012",
    "summary": "A beautiful ceramic mug for hot beverages"
  }
]'
```