API Key

Get an API Key

Manage Your API Key

Top APIs

Consolidated Screening List

Trade Events

Trade Leads

Tariff Rates

De Minimis

API Resources

List of all APIs

Search Widgets

ITA Taxonomy

Consolidated Screening List API

The Consolidated Screening List API consolidates eleven export screening lists of the Departments of Commerce, State and the Treasury into a single data feed as an aid to industry in conducting electronic screens of potential parties to regulated transactions.

In the event that a company, entity or person on the list appears to match a party potentially involved in an export transaction, additional due diligence should be conducted before proceeding. There may be a strict export prohibition, requirement for seeking a license application, evaluation of the end-use or user to ensure it does not result in an activity prohibited by any U.S. export regulations, or other restriction. For more information view the informational video from the National Customs Brokers.

Note: The API only contains active entities on the list. For historical research, please reference the sources directly.

The output format for this API is JSON. This data set is updated hourly. Test the API using the demo search app. Be sure to sign up for an API key to get access to the API.

When using this API, developers must provide the following information to their users to help them stay compliant with exporting law.

If a party to a user’s transaction matches the name of a party on the consolidated list, the user must check the official publication of restricted parties in the Federal Register or the official lists of restricted parties maintained on the websites of the Departments of Commerce, State and the Treasury to ensure full compliance with all of the terms and conditions of the restrictions placed on the parties on this list. Links to these websites are found below as well as in the “Source List URL” and “Source Information URL” fields that accompany each party returned in the API. These links connect users to the specific webpage that contain additional information about how to use each specific list.

If you are interested in learning which countries the U.S. has sanctions against, visit the U.S. Department of Treasury's Sanctions Programs and Country Information page.

There are many screening lists available that developers can integrate with this Consolidated Screening List API. Because this API only provides screening lists that relate to the export of products from the U.S. to foreign countries, consider other screening lists that address the sale of products domestically or the sales among foreign countries.

Furthermore, the results in this API often refer to notices in the Federal Register. Consider mashing this API with data from the Federal Register to create a more comprehensive search tool.

Resource URL

This endpoint will search across all eleven screening lists. To search a subset, see sources below.

Search Parameters for Consolidated Screening List Sources

keyword

Searches for a match within the name, alt_names, remarks, and title fields from all eleven lists.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&q={term}

Example

sources

Searches only the lists specified by the Source Abbreviation.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&sources={csl_type}

Example

For each list, the Source Abbreviations are as follows:

Department of Commerce – Bureau of Industry and Security (BIS)
Denied Persons List = DPL
Entity List = EL
Unverified List = UVL

Department of State – Bureau of International Security and Non-Proliferation
Nonproliferation Sanctions = ISN

Department of State – Directorate of Defense Trade Controls
ITAR Debarred = DTC

Department of Treasury - Office of Foreign Assets Control
Foreign Sanctions Evaders = FSE
Non-SDN Iranian Sanctions Act List = ISA
Palestinian Legislative Council List = PLC
Part 561 List = 561
Sectoral Sanctions Identifications List = SSI
Specially Designated Nationals = SDN

countries

Searches only entities whose country, nationalities, or citizenships fields match the country code based on ISO alpha-2 country codes. The country fields are found in the addresses and ids arrays. This method allows you to search for multiple countries (plural) separated by commas but will only return one country (singular) per entity.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&countries={country code}

Example

address

Searches against fields in the addresses array.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&address={query}

Example

name

Searches against the name and alt_names fields.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&name={query}

Example

fuzzy_name

Fuzzy name matching enables users to query a name and get usable results without knowing the exact spelling of an entry. It works by expanding queries to include results that are fuzzily similar to the given term, where similarity is defined by distance - the number of changes required to get from one term to another.

The following example contains terms with a distance of 1. Valid transformation types are given in parenthesis.

star => stir  (substitution)
star => stars (insertion)
star => tar   (deletion)
star => tsar  (transposition)

This notion of distance between strings is defined formally as Damerau–Levenshtein distance

We allow for fuzzy matching up to a distance of 2. For example, a search for Mohamed, will return matches on the following variants of the name (among others).

query term distance
Mohamed 0
Mohamad 1
Muhamed 1
Muhamet 2
Mohammed 1
Muhammed 2
 

Fuzzy matching can be particularly helpful with names that are commonly transliterated into English in various ways.

Results from a fuzzy name search include a score. The higher the score, the more closely the query term matches an entry in the consolidated screening list.

Note: The fuzzy_name parameter only works in tandem with name. Set fuzzy_name=true to utilize fuzzy name matching when searching against the name and alt_names fields. The default setting for fuzzy_name is false, which means the endpoint will only return exact matches.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&name={query}&fuzzy_name=true

Also, special characters such as hashtags (#) and ampersands (&) contained in a need to be URL encoded; e.g., AT&T should be encoded as at%26t.

Example

type

Searches based on the type of the entry (e.g, Individual, Entity, Vessel).

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&type={entry type}

Example

start_date

Returns entries based on their start date. Dates are filtered by comparing them against an inclusive range, which must be entered with the following format: YYYY-mm-dd TO YYYY-mm-dd. Searching on a single date can be done by entering the same value for the start and end of the range.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&start_date={YYYY-mm-dd TO YYYY-mm-dd}

Example

end_date

Returns entries based on their end date. Dates are filtered by comparing them against an inclusive range, which must be entered with the following format: YYYY-mm-dd TO YYYY-mm-dd. Searching on a single date can be done by entering the same value for the start and end of the range.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&end_date={YYYY-mm-dd TO YYYY-mm-dd}

Example

issue_date

Returns entries based on the issue dates of the ids array. Dates are filtered by comparing them against an inclusive range, which must be entered with the following format: YYYY-mm-dd TO YYYY-mm-dd. Searching on a single date can be done by entering the same value for the start and end of the range.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&issue_date={YYYY-mm-dd TO YYYY-mm-dd}

Example

expiration_date

Returns entries based on the expiration dates of the ids array. Dates are filtered by comparing them against an inclusive range, which must be entered with the following format: YYYY-mm-dd TO YYYY-mm-dd. Searching on a single date can be done by entering the same value for the start and end of the range.

https://api.trade.gov/consolidated_screening_list/search?api_key={your key}&expiration_date={YYYY-mm-dd TO YYYY-mm-dd}

Example

size + offset

The size parameter allows you to configure the number of results to be returned up to a maximum of 100. The offset parameter defines the offset from the first result you want to fetch. Unless specified the API returns 10 results at a time.

https://api.trade.gov/consolidated_screening_list/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 list and the issuing agency.
source_last_updated The most recent date and time the list changed.
last_imported The most recent date and time the list was imported.

The source_last_updated field reflects the most recent date and time we noticed that the issuing agency had updated their list. We check for updates and import lists hourly.

Search Performed At

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

The Eleven Screening Lists, Their Sources and Specific Fields

Each list returns a unique set of fields. Where appropriate, the Consolidated Screening List normalizes the field names, such as addresses, start_date, and federal_register_notice.

Department of Commerce – Bureau of Industry and Security (BIS)

Denied Persons List (DPL)

Individuals and entities that have been denied export privileges. Any dealings with a party on this list that would violate the terms of its denial order are prohibited.

Example

Field Description
addresses Array of entity’s complete addresses.
     address Street address for addresses entry.
     city City for addresses entry.
     state State for addresses entry.
     postal_code Postal code for addresses entry.
     country Country for addresses entry.
end_date The date on which the entity’s inclusion on the list will be lifted, waived, or will have expired.
federal_register_notice The official source of information about the parties on this list.
name Entity’s name.
remarks Additional remarks or notes regarding the company, entity, or person on the list.
source Denied Persons List (DPL) - Bureau of Industry and Security.
source_information_url Information from the Source agency about the list.
source_list_url Location of the original list.
standard_order Whether or not (Y/N) the standard order applies to the Denied Party as defined by the Bureau of Industry and Security (BIS).
start_date The effective date for the entity to be included on the list as defined by the Federal Register Notice.

Entity List (EL)

Parties whose presence in a transaction can trigger a license requirement supplemental to those elsewhere in the Export Administration Regulations (EAR). The list specifies the license requirements and policy that apply to each listed party.

Example

Field Description
addresses Array of entity’s complete addresses.
     address Street address for addresses entry.
     city City for addresses entry.
     state State for addresses entry.
     postal_code Postal code for addresses entry.
     country Country for addresses entry.
alt_names Alias names used by the entity.
federal_register_notice The official source of information about the parties on this list.
license_policy The policy set forth in the Export Administration Regulations regarding denial.
license_requirement The license requirement as determined by the Export Administration Regulations.
name Entity’s name.
title Entity’s title.
source Entity List (EL) - Bureau of Industry and Security.
source_information_url Information from the Source agency about the list.
source_list_url Location of the original list.
standard_order Whether or not (Y/N) the standard order applies to the Denied Party as defined by the Bureau of Industry and Security (BIS).
start_date The effective date of the entity on the list as defined by the Federal Register Notice.

Unverified List (UVL)

End-users who BIS has been unable to verify in prior transactions. The presence of a party on this list in a transaction is a “Red Flag” that should be resolved before proceeding with the transaction.

Example

Field Description
addresses Array of entity’s complete addresses.
     address Street address for addresses entry.
     city City for addresses entry.
     state State for addresses entry.
     postal_code Postal code for addresses entry.
     country Country for addresses entry.
alt_names Alias names used by the entity.
name Entity’s name.
source Unverified List (UVL) - Bureau of Industry and Security.
source_information_url Information from the Source agency about the list.
source_list_url Location of the original list.

Department of State – Bureau of International Security and Non-Proliferation

Nonproliferation Sanctions (ISN)

Parties that have been sanctioned under various statutes. The linked webpage is updated as appropriate, but the Federal Register is the only official and complete listing of nonproliferation sanctions determinations.

Example

Field Description
addresses Array of entity’s complete addresses.
     address Street address for addresses entry.
     city City for addresses entry.
     state State for addresses entry.
     postal_code Postal code for addresses entry.
     country Country for addresses entry.
federal_register_notice The official source of information about the parties on this list.
name Entity’s name.
programs Agency programs related to the entity on the list.
remarks Additional remarks or notes regarding the company, entity or person on the list.
source Nonproliferation Sanctions (ISN) - State Department.
source_information_url Information from the Source agency about the list.
source_list_url Location of the original list.
start_date The effective date of the entity on the list as defined by the Federal Register Notice.

Department of State – Directorate of Defense Trade Controls

ITAR Debarred List (DTC)

Entities and individuals prohibited from participating directly or indirectly in the export of defense articles, including technical data and defense services. Pursuant to the Arms Export Control Act (AECA) and the International Traffic in Arms Regulations (ITAR), the AECA Debarred List includes persons convicted in court of violating or conspiring to violate the AECA and subject to “statutory debarment” or persons established to have violated the AECA in an administrative proceeding and subject to “administrative debarment.”

This list does not have a country field. As such, any query where country is specified will not search this list.

Example

Field Description
alt_names Alias names used by the entity.
federal_register_notice The official source of information about the parties on this list.
name Entity’s name.
source ITAR Debarred (DTC) - State Department.
source_information_url Information from the Source agency about the list.
source_list_url Location of the original list.
start_date The effective date of the entity on the list as defined by the Federal Register Notice.

Department of the Treasury – Office of Foreign Assets Control (OFAC)

Foreign Sanctions Evaders List (FSE)

Foreign individuals and entities determined to have violated, attempted to violate, conspired to violate, or caused a violation of U.S. sanctions on Syria or Iran, as well as foreign persons who have facilitated deceptive transactions for or on behalf of persons subject to U.S. Sanctions. Transactions by U.S. persons or within the United States involving Foreign Sanctions Evaders (FSEs) are prohibited.

Example

Palestinian Legislative Council List (PLC)

The individuals in this list are Palestinian Legislative Council members who were elected on the party slate of a Foreign Terrorist Organization, Specially Designated Terrorist, or Specially Designated Global Terrorist. They do not, however, appear on the SDN List. Transactions involving these individuals must be rejected.

Example

Sectoral Sanctions Identifications List (SSI)

This Sectoral Sanctions Identifications List includes persons determined by OFAC to be operating in sectors of the Russian economy identified by the Secretary of the Treasury pursuant to Executive Order 13662. The prohibitions on dealings related to the persons identified on this list are described in the Sectoral Sanctions Identifications List circular.

Example

Specially Designated Nationals List (SDN)

Parties who may be prohibited from export transactions based on OFAC’s regulations. The Export Administration Regulations (EAR) require a license for exports or re-exports to any party in any entry on this list that contains any of the suffixes “SDGT”, “SDT”, “FTO”, “IRAQ2” or “NPWMD”.”

Example

Part 561 List (561)

The Part 561 List includes the names of foreign financial Institutions that are subject to sanctions, certain prohibitions, or strict conditions before a U.S. company may do business with them.

Example

Non-SDN Iranian Sanctions Act List (ISA)

The ISA List includes persons determined to have made certain investments in Iran’s energy sector or to have engaged in certain activities relating to Iran’s refined petroleum sector. Their names do not appear on the Specially Designated Nationals or Blocked Persons (SDN) List, and their property and/or interests in property are not blocked, pursuant to this action.

Example

Fields for all Treasury Lists:

Field Description
addresses Array of entity’s complete addresses.
     address Street address for addresses entry.
     city City for addresses entry.
     state State for addresses entry.
     postal_code Postal code for addresses entry.
     country Country for addresses entry.
alt_names Alias names used by the entity.
citizenships Entity’s citizenships.
dates_of_birth Entity’s dates of birth.
entity_number Unique id assigned by the originating list.
ids An array showing specific identification information of the entity. Array fields in italics.
     country Entity’s country .
     expiration_date The date on which the identification will expire.
     issue_date The effective date of the identification.
     number Unique number assigned to the identification.
     type Describes the type of identification (i.e. passport, license, etc.).
name Entity’s name.
nationalities Entity’s nationalities.
places_of_birth Entity’s places of birth.
programs Agency programs related to the entity on the list.
remarks Additional remarks or notes regarding the company, entity or person on the list.
source Specially Designated Nationals (SDN) - Treasury Department.
source_information_url Information from the Source agency about the list.
source_list_url Location of the original list.
title Entity’s title.
type Classification of the entity.

If the entity is a vessel, it will have the following additional fields:

Field Description
call_sign Call sign of the vessel.
gross_registered_tonnage The gross weight in tons registered for the vessel.
gross_tonnage The gross weight in tons not-registered for the vessel.
vessel_flag Country flag of the vessel.
vessel_owner Owner/Operator of the vessel.
vessel_type Describes the type of vessel (ferry, bulk cargo, tug).

OFAC provides further documentation for the programs field.

ITA’s Process for Consolidating the Screening Lists

ITA’s data services platform imports each of the eleven screening lists once every hour. It then consolidates the lists based on common field types such as name, federal_register_notice, and start_date. Not all lists contain the same fields so some search results may include more detail than others depending upon the Source agency. Once the data services platform consolidates the lists, it publishes the CSL API endpoint.

There can be a time lag of up to one hour between the time a Source has updated a screening list and when that update appears in the Consolidated Screening List API. Furthermore, the Consolidated Screening List API is not the system of record for these screening lists. Developers should strongly encourage users to refer to the website of the source agency for further instructions when finding a potential match. Links to these websites are found above as well as in the “Source List URL” and “Source Information URL” fields that accompany each party returned in the API.