Get Warnings
Endpoint
GET https://api.iosco.org/v1/i-scan/warnings
Headers
Authorizationstringrequired
Bearer <<YOUR_API_KEY_HERE>>
Content-Typestringrequired
application/json
Parameters
The following parameters can be included in the query string or the request body in order to filter the results sent back by the endpoint. If not provided, the default values (if listed) of each parameter will be used.
Please note that all parameters will be joined using the AND logical operator.
idinteger
The unique integer that is assigned to the warning.
ncaidarray[integer]
An array of "NCA" IDs representing NCAs.
The list below represents the list of NCAs that have warnings posted. This list will be updated in real-time.
ID | NCA |
---|---|
430 | Abu Dhabi - Financial Services Regulatory Authority |
2 | Alberta - Alberta Securities Commission |
417 | Angola - Comissão do Mercado de Capitais |
5 | Argentina - Comisión Nacional de Valores |
311 | Armenia - Central Bank of Armenia |
7 | Australia - Australian Securities and Investments Commission |
8 | Austria - Financial Market Authority |
9 | Bahamas - Securities Commission of The Bahamas |
13 | Belgium - Financial Services and Markets Authority |
14 | Bermuda - Bermuda Monetary Authority |
17 | Brazil - Comissão de Valores Mobiliários |
3 | British Columbia - British Columbia Securities Commission |
335 | British Virgin Islands - British Virgin Islands Financial Services Commission |
18 | Bulgaria - Financial Supervision Commission |
89 | Chinese Taipei - Financial Supervisory Commission |
23 | Croatia, Republic of - Croatian Financial Services Supervisory Agency |
24 | Cyprus - Cyprus Securities and Exchange Commission |
25 | Czech Republic - Czech National Bank |
26 | Denmark - Danish Financial Supervisory Authority |
314 | DIFC, Dubai - Dubai Financial Services Authority |
27 | Dominican Republic - Superintendencia del Mercado de Valores |
34 | France - Autorité des marchés financiers |
35 | Germany - Bundesanstalt für Finanzdienstleistungsaufsicht |
324 | Gibraltar - Gibraltar Financial Services Commission |
37 | Greece - Hellenic Capital Market Commission |
39 | Hong Kong - Securities and Futures Commission |
43 | Ireland - Central Bank of Ireland |
44 | Isle of Man - Isle of Man Financial Services Authority |
46 | Italy - Commissione Nazionale per le Società e la Borsa |
48 | Japan - Financial Services Agency |
49 | Jersey - Jersey Financial Services Commission |
50 | Jordan - Jordan Securities Commission |
450 | Kuwait - Capital Markets Authority |
370 | Liechtenstein - Financial Market Authority |
56 | Lithuania - Bank of Lithuania |
57 | Luxembourg - Commission de Surveillance du Secteur Financier |
58 | Malaysia - Securities Commission |
278 | Malta - Malta Financial Services Authority |
60 | Mauritius - Financial Services Commission |
61 | Mexico - Comisión Nacional Bancaria y de Valores |
313 | Montenegro - Capital Market Authority of Montenegro |
64 | New Zealand - Financial Markets Authority |
65 | Nigeria - Securities and Exchange Commission |
68 | Ontario - Ontario Securities Commission |
69 | Pakistan - Securities and Exchange Commission |
70 | Panama - Superintendencia del Mercado de Valores |
75 | Poland - Polish Financial Supervision Authority |
76 | Portugal - Comissão do Mercado de Valores Mobiliários |
426 | Qatar - Qatar Financial Centre Regulatory Authority |
77 | Quebec - Autorité des marchés financiers |
78 | Romania - Financial Supervisory Authority |
490 | Seychelles - Financial Services Authority |
82 | Slovenia - Securities Market Agency/Agencija Za Trg Vrednostnih Papirjev |
84 | Spain - Comisión Nacional del Mercado de Valores |
87 | Sweden - Finansinspektionen |
88 | Switzerland - Swiss Financial Market Supervisory Authority |
63 | The Netherlands - The Dutch Authority for the Financial Markets |
93 | Tunisia - Conseil du marché financier |
96 | Ukraine - National Securities and Stock Market Commission |
97 | United Kingdom - Financial Conduct Authority |
108 | United States of America - Commodity Futures Trading Commission |
98 | United States of America - Securities and Exchange Commission |
353 | United States of America - Securities Investor Protection Corporation |
99 | Uruguay - Banco Central del Uruguay |
keywordsstring
Keywords to search for.
Max length: 200
categoriesarray[integer]
An array of "Category" IDs indicating the reason the entity has been warned by the NCA.
ID | Category |
---|---|
1 | Unregistered/Unlicensed entity offering financial products or services |
2 | Registered/Licensed entity impersonators |
3 | Regulator/Government impersonators |
4 | Market Manipulation (pump and dump schemes, wash trades, etc.) |
5 | Fraud and Other Types of Misconduct |
6 | General enforcement alerts |
7 | Other |
productsarray[integer]
An array of "Product" IDs indicating financial products or services offered by the unauthorised entity.
ID | Product |
---|---|
1 | Stocks and bonds |
2 | Money-market instruments |
3 | Units in collective investment undertakings |
4 | Investment contracts |
5 | Derivatives (options, futures, binary options, CFDs, forex, swaps, etc.) |
6 | Crypto and Digital Assets |
7 | Other |
validation_date_startdate
Date on which IOSCO validates the warning submitted by the NCA after conducting an assessment of the information to be published (e.g., to avoid the inclusion of personal data). If specified, will return all warnings after (and including) this date.
Format: YYYY-MM-DD
validation_date_enddate
Date on which IOSCO validates the warning submitted by the NCA after conducting an assessment of the information to be published (e.g., to avoid the inclusion of personal data). If specified, will return all warnings before (and including) this date.
Format: YYYY-MM-DD
modification_date_startdate
Date on which a warning was last modified (added or updated). If specified, will return all warnings after (and including) this date.
Format: YYYY-MM-DD
modification_date_enddate
Date on which a warning was last modified (added or updated). If specified, will return all warnings before (and including) this date.
Format: YYYY-MM-DD
Response Summary
Returns a single warning object or an array of warning objects.
idinteger
The unique integer that is assigned to the warning.
nca_idinteger
The unique integer representing the NCA that posted the warning.
nca_namestring
Name of the NCA that posted the warning.
nca_jurisdictionstring
Jurisdiction of the NCA that posted the warning.
nca_registration_datedate
Date on which the NCA published the warning in its jurisdiction.
Format: YYYY-MM-DD
nca_urlstring
Url to the warning on the website of the NCA that uploaded it.
commercial_namestring
Commercial name of the warned about entity.
other_commercial_namesarray[string]
An array of other "commercial names" for the warned about entity identified by the NCA.
corporate_namesarray[string]
An array of "corporate (legal) name(s)" for the warned about entity detected by the NCA.
urlstring
URL of the warned about entity's website.
other_urlsarray[string]
An array of any other "URLs" for the warned about entity detected by the NCA.
domain_namestring
Domain name of the entity's URL.
fqdnstring
Fully qualified domain name (specifies all domain levels, including the top-level domain and the root zone).
ip_address_v4string
IP address (v4) of the entity's website.
ip_address_v6string
IP address (v6) of the entity's website.
emailarray[string <email>]
Contact email addresses included in the entity's website.
leistring
Legal Entity Identifier (LEI)
categoriesarray[integer]
An array of "Category" IDs indicating the reason the entity has been warned by the NCA.
ID | Category |
---|---|
1 | Unregistered/Unlicensed entity offering financial products or services |
2 | Registered/Licensed entity impersonators |
3 | Regulator/Government impersonators |
4 | Market Manipulation (pump and dump schemes, wash trades, etc.) |
5 | Fraud and Other Types of Misconduct |
6 | General enforcement alerts |
7 | Other |
categories_detailedarray[string]
An array of "Category" description strings indicating the reason the entity has been warned by the NCA.
productsarray[integer]
An array of "Product" IDs indicating financial products or services offered by the unauthorised entity.
ID | Product |
---|---|
1 | Stocks and bonds |
2 | Money-market instruments |
3 | Units in collective investment undertakings |
4 | Investment contracts |
5 | Derivatives (options, futures, binary options, CFDs, forex, swaps, etc.) |
6 | Crypto and Digital Assets |
7 | Other |
products_detailedarray[string]
An array of "Product" description strings indicating financial products or services offered by the unauthorised entity.
social_mediaarray[object]
An array of objects (platform and handle) of social media details used by the entity to reach users.
platforminteger
Social media platform ID.
ID | Description |
---|---|
1 | BeReal |
2 | Discord |
3 | Douyin |
4 | |
5 | Facebook Messenger |
6 | |
7 | Kuaishou |
8 | |
9 | |
10 | |
11 | Quora |
12 | Qzone |
13 | |
14 | Snapchat |
15 | Telegram |
16 | TikTok |
17 | Tumblr |
18 | Twitch |
19 | |
20 | |
21 | |
22 | X (Twitter) |
23 | YouTube |
handlestring
Social media handle used by the entity.
social_media_detailedarray[object]
An array of objects (platform and handle) of social media details used by the entity to reach users.
platformstring
Social media platform used by the entity.
handlestring
Social media handle used by the entity.
regulator_claimsarray[string]
An array of regalator names that the entity claims to be regulated by on its website.
additional_informationstring
Any additional information that the NCA deems appropriate.
validation_datedate
Date on which IOSCO validates the warning submitted by the NCA after conducting an assessment of the information to be published (e.g., to avoid the inclusion of personal data).
Format: YYYY-MM-DD
modification_datedate
Date on which the warning was last modified (added or updated).
Format: YYYY-MM-DD
Example JSON GET
Query String
https://api.iosco.org/v1/i-scan/warnings?ncaid=[89,97]&keywords=XYZ Company&categories=[1]&products=[3]&validation_date_start=2024-10-17&validation_date_end=2024-10-17
Request Body
{ "ncaid": [89,97], "keywords": "XYZ Company", "categories": [1], "products": [3], "validation_date_start": "2024-10-17", "validation_date_end": "2024-10-17" }
cURL Example
curl -X GET "https://api.iosco.org/v1/i-scan/warnings" \ -H "Authorization: Bearer <<YOUR_API_KEY_HERE>>" \ -H "Content-Type: application/json" \ -d '{ "ncaid": [89,97], "keywords": "XYZ Company", "categories": [1], "products": [3], "validation_date_start": "2024-10-17", "validation_date_end": "2024-10-17" }'
Example JSON Response
Returns a single warning object or an array of warning objects.
[ { "id": 34250, "nca_id": 97, "nca_name": "Financial Conduct Authority", "nca_jurisdiction": "United Kingdom", "nca_registration_date": "2024-10-01", "nca_url": "https://www.iosco.org/investor_protection/ue/", "commercial_name": "XYZ Company", "other_commercial_names": [ "Empresa XYZ", "Free Money Inc.", "Société XYZ" ], "corporate_names": [ "XYZ Corporation" ], "url": "https://www.free-money.com", "other_urls": [ "https://free-money.co", "https://free-money.edu", "https://free-money.org" ], "domain_name": "free-money.com", "fqdn": "www.free-money.com", "ip_address_v4": "127.0.0.1", "ip_address_v6": "0:0:0:0:0:0:0:1", "email": [ "brad@free-money.com" ], "lei": "505752GE1G88325QX363", "categories": [ 1, 5 ], "categories_detailed": [ "Regarding fraudulent or manipulative practices (insider dealing, market manipulation, misrepresentation of material information, etc.)", "Regarding Emerging Digital Threats including ICOs and crypto-assets" ], "products": [ 1, 3 ], "products_detailed": [ "Product 1", "Product 3" ], "social_media": [ { "platform": 4, "handle": "free.money" }, { "platform": 22, "handle": "@freemoney" } ], "social_media_detailed": [ "Facebook: free.money", "X (Twitter): @freemoney" ], "regulator_claims": [ "United Kingdom - Supervisory Conduct Authority" ], "additional_information": "There is no public authority named \"Supervisory Conduct Authority\" in the United Kingdom.", "validation_date": "2024-10-17", "modification_date": "2024-10-17" } ]