# tradeData

Get import schedule data.

`GET /hscodeselfclassify/tradedata/importschedule/{hscode}/{origin}/{destination}`

**API:** Avalara Cross Border Tariff Content
**Tag:** Tradedata
**API Version:** 1.0
**Base URL:** /
**Authentication:** Bearer token

Source: https://developer.avalara.com/products/trade-and-tariff-library/api/methods/Tradedata/tradeData/

## Description

Gets the import schedule data for a specific HS code, origin, and destination country.

## Parameters

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `hscode` | string | path | Yes | The HS (Harmonized System) code for the product. |
| `origin` | string | path | Yes | The code for origin country in ISO 3166-1 alpha-2 format. |
| `destination` | string | path | Yes | The code for destination country in ISO 3166-1 alpha-2 format. |
| `language` | string | query | No | The language code for the response. |
| `avalara-version` |  | header | Yes | API version. Current version is 1.0. |

## Responses

| Status | Description | Schema |
|---|---|---|
| 200 | Returns the import schedule data for the requested HS code, origin, and destination. | `ImportScheduleProjection` |
| 400 | The request parameters are invalid. | `AvalaraAPIExceptionDetails` |
| 401 | Authentication failed due to invalid or missing authentication token. | `AvalaraAPIExceptionDetails` |
| 403 | Customer is not authorized to access this resource. | `AvalaraAPIExceptionDetails` |
| 500 | An unexpected server error occurred. | `AvalaraAPIExceptionDetails` |

### 200 Response: `ImportScheduleProjection`

Import duty schedule for a destination country, including the country identification, the schedule version, the default duty group name, and the hierarchical tree of tariff entries.

| Property | Type | Required | Description |
|---|---|---|---|
| `country` | string | No | Display name of the destination country, in uppercase. Example: `UNITED KINGDOM`. |
| `iso2` | string | No | Destination country code in ISO 3166-1 alpha-2 format. Example: `GB`. |
| `version` | string | No | Version identifier of the tariff data used to build this import schedule. Example: `2_2`. |
| `generalGroupName` | string | No | Name of the default duty group that applies when no more specific group matches. Example: `All Countries Duty Rate`. |
| `children` | TradeDataProjection[] | No | Hierarchical tree of tariff entries (sections, chapters, headings, and items) that make up the import schedule for this destination. |