API Key

Get an API Key

Manage Your API Key

Top APIs

Consolidated Screening List

Trade Events

Trade Leads

FTA Tariff Rates

De Minimis

API Resources

List of all APIs

Search Widgets

ITA Taxonomy

FTA Tariff Rates API

The FTA Tariff Rates API provides data about each country with whom the United States has a Free Trade Agreement (FTA). When the U.S. enters into an FTA with a foreign government, it negotiates lower tariff rates with that government for a wide variety of products. A tariff is a tax that a company must pay a foreign country when shipping a product to that country. Typically the FTA tariffs rates decline over several years.

The API provides information on tariff rates for the following countries: Australia, Bahrain, Chile, Colombia, Costa Rica, Dominican Republic, El Salvador, Guatemala, Honduras, Morocco, Nicaragua, Oman, Panama, Peru, Singapore, and South Korea. Products are indicated by their HS-6 code.

Because the North American Free Trade Agreement (NAFTA) tariff rates have declined to zero, Canada and Mexico data is not included. Similarly, the tariff rates for almost all products shipped to Israel and Jordon have declined to zero and are not included here.

The output format for this API is JSON. This data set is updated only when the corresponding Free Trade Agreement is negotiated or updated. Test the API using the demo search app. Be sure to sign up for an API key to get access to the API.

Free Trade Agreements help lower the cost for companies to ship their products overseas. Knowing tariffs rates for exporting specific products to each country helps companies understand the true cost of doing business with that country. There are other tariff schedules, such as those negotiated by the World Bank, so it’s important for U.S. companies to know their options.

For more information read the U.S. Free Trade Agreements page on export.gov. U.S. businesses should pay close attention to the Rules of Origin pages for each country to determine whether or not their product qualifies for the reduced tariff rates under that FTA.

The FTA API only includes tariff data for the 16 countries listed on the Background tab. The World Trade Organization publishes trade agreements among many countries around the world, not just those with the U.S. As such, they have different tariff rates that developers can use to compare with the rates in this API.

The United States Department of Agriculture (USDA) also publishes tariff rates from the same FTAs that this API uses as a source. The USDA does not publish rates for as many countries as this API, however they do provide more detailed information, especially about products that have safeguards and quotas. They also list the thresholds where the tariff rate changes when the quantity of the product being shipped changes.

The U.S. Census Bureau provides a search tool for finding the HS-6 code assigned to a particular product. Developers could integrate this functionality into their own tool to help U.S. companies find tariff rates for their products more easily.

Mashed together, the data from this API as well as the data from the World Bank, the USDA, and Census can enhance Web pages about shipping particular products overseas.

Resource URL

Search Parameters

keyword

Searches for a match within the subheading_description, tariff_rate_quota_note, rule_text, and tariff_line fields.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&q={term}

Example

sources

Returns tariff rates based on the ISO alpha-2 country codes of the source country. This method allows you to search for multiple sources (plural) separated by commas.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&sources={source countries}

Example

final_years

Returns entries based on the final_year field. Years are specified as a comma-delimited list.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&final_years={YYYY,YYYY}

Example

partner_start_years

Returns entries based on the partner_start_year field. Years are specified as a comma-delimited list.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&partner_start_years={YYYY,YYYY}

Example

reporter_names

Returns entries based on the reporter_names field. Reporter names are specified as a comma-delimited list.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&reporter_names={first+reporter+name,second+reporter+name}

Example

reporter_start_years

Returns entries based on the reporter_start_year field. Years are specified as a comma-delimited list.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&reporter_start_years={YYYY,YYYY}

Example

size + offset

The size parameter allows you to configure the maximum amount of hits to be returned. The offset parameter defines the offset from the first result you want to fetch.

https://api.govwizely.com/v1/tariff_rates/search?api_key={your key}&size={1 to 100}&offset={1 to n}

Example

Metadata

Last Updated and Last Imported

Recency information about each source queried is given in sources_used in the following fields:

Field Description
source The name of the country.
source_last_updated The most recent date and time the data changed.
last_imported The most recent date and time the data was imported.

The source_last_updated field reflects the most recent date and time we noticed that the data for the source country had been updated.

Search Performed At

The search_performed_at field displays the date and time of the current search in UTC.

Return Values

Field Description
source Two letter code for the “reporter” country with whom the U.S. has the Free Trade Agreement.
source_id Unique identifier.
tariff_line Product’s Harmonized System (HS) code for the product according to the reporter’s nomenclature.
subheading_description English description at the subheading level (6-digit HS code). 
hs_6 6-digit HS code for the product.
base_rate The numeric tariff rate from which tariff reductions are calculated. Typically, this is the applied tariff rate at the time the FTA was negotiated.
base_rate_alt The non-numeric (specific) tariff rate from which the tariff reductions are calculated. Typically, this is the applied tariff rate at the time the FTA was negotiated.
final_year The year the tariff is eliminated under the FTA.
tariff_rate_quota Flag noting tariff treatment for products within quota (2) and out of quota (1).
tariff_rate_quota_note Text note about the tariff-rate quota (TRQ) applicable to the product.
tariff_eliminated  Flag noting whether or not the tariff is eventually eliminated. “False”= not eliminated.
partner_name Exporting country’s code.
reporter_name Importing country’s code.
staging_basket  The agreed tariff phase-out period for the product under the FTA.
partner_start_year  Year the agreement entered into force for the partner. (The first year of tariff cuts).
reporter_start_year Year the agreement entered into force for the reporter. (The first year of tariff cuts).
partner_agreement_name Agreement name for the partner country.
reporter_agreement_name Agreement name for the reporter country.
quota_name Description for products subject to tariff-rate quotas. (Describes in-quota and out-of-quota tariff lines).
rule_text Text describing the applicable rule of origin for the product.
link_text Text describing URL to more detailed rule of origin information.
link_url URL to more detailed rule of origin information.
annual_rates Numeric year-by-year tariff rates under the FTA as the tariff is eliminated.
annual_rates_alt  Non-numeric (specific) year-by-year tariff rates under the FTA.