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.
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 export.gov CSL 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. Consider mashing this API with data from the Federal Register to create a more comprehensive search tool.
Note:
It has been discovered that erroneous entries have been appearing on the Non-SDN Iranian Sanction Act List (NS-ISA) in the CSL API. A change is being made to alter metadata that were incorrectly associated with these records. The names in question are on OFAC’s EO13599 list and US persons are prohibited from dealing with them.
If you have any question regarding this change, please e-mail us at DataServices@trade.gov Thank you.
This endpoint will search across all screening lists. To search a subset, see sources below.
Searches for a match within the name, alt_names, remarks, and title fields from all eleven lists.
https://api.govwizely.com/consolidated_screening_list/search?api_key={your key}&q={term}
Example
Searches only the lists specified by the Source Abbreviation.
https://api.govwizely.com/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
Blocked Solely Pursuant to Executive Order 13599 = 13599
Foreign Sanctions Evaders = FSE
Palestinian Legislative Council List = PLC
Part 561 List = 561
Sectoral Sanctions Identifications List = SSI
Specially Designated Nationals = SDN
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.govwizely.com/consolidated_screening_list/search?api_key={your key}&countries={country code}
Example
Searches against fields in the addresses array.
https://api.govwizely.com/consolidated_screening_list/search?api_key={your key}&address={query}
Example
Searches against the name and alt_names fields.
https://api.govwizely.com/consolidated_screening_list/search?api_key={your key}&name={query}
Example
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 Smith, will return matches on the following variants of the name (among others).
query term | distance |
---|---|
Smith | 0 |
Smyth | 1 |
Smithy | 1 |
Smythe | 2 |
Stitch | 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.govwizely.com/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
Searches based on the type of the entry (e.g, Individual, Entity, Vessel).
https://api.govwizely.com/consolidated_screening_list/search?api_key={your key}&type={entry type}
Example
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.govwizely.com/consolidated_screening_list/search?api_key={your key}&start_date={YYYY-mm-dd TO YYYY-mm-dd}
Example
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.govwizely.com/consolidated_screening_list/search?api_key={your key}&end_date={YYYY-mm-dd TO YYYY-mm-dd}
Example
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.govwizely.com/consolidated_screening_list/search?api_key={your key}&issue_date={YYYY-mm-dd TO YYYY-mm-dd}
Example
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.govwizely.com/consolidated_screening_list/search?api_key={your key}&expiration_date={YYYY-mm-dd TO YYYY-mm-dd}
Example
Returns entries sorted by the provided field name. The possible fields to sort by are name, start_date, issue_date, end_date, and expiration_date.
Enter the field name followed by a colon, then the desired order asc (ascending) or desc (descending). For example, start_date:desc sorts results from most recent start date to earliest. Entries that do not contain the entered field or contain a null or empty value will be returned after the sorted results.
Note: By default, searches that do not contain a full-text search (q, name, address) will return results by name:asc even if no sort parameter is entered.
https://api.govwizely.com/consolidated_screening_list/search?api_key={your key}&sort={fieldname:order}
Example
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.govwizely.com/consolidated_screening_list/search?api_key={your key}&size={1 to 100}&offset={1 to n}
Example
Note: When using multiple parameters, the result set will contain the intersection of the matches determined by the parameter values.
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.
The search_performed_at field displays the date and time of the current search in UTC.
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.
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. |
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. |
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. |
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. |
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. |
Blocked Solely Pursuant to Executive Order 13599 (13599)
The 13599 List is a list of persons identified by OFAC as meeting the definition of the term Government of Iran or the term Iranian financial institution. Pursuant to Executive Order 13599, the property and interests in property of persons included on this list, as well as property such as vessels identified on this list, must be blocked if they are in or come within the United States or if they are in or come within the possession or control of a U.S. person, wherever located.
Example
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
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
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 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.
USA.gov | FOIA | Privacy Policy | Disclaimer | Information Quality Guidelines | Terms of Service
The International Trade Administration, U.S. Department of Commerce, manages this global trade site to provide access to ITA information on promoting trade and investment, strengthening the competitiveness of U.S. industry, and ensuring fair trade and compliance with trade laws and agreements. External links to other Internet sites should not be construed as an endorsement of the views or privacy policies contained therein.