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 Facebook
5 Facebook Messenger
6 Instagram
7 Kuaishou
8 LinkedIn
9 Pinterest
10 QQ
11 Quora
12 Qzone
13 Reddit
14 Snapchat
15 Telegram
16 TikTok
17 Tumblr
18 Twitch
19 WeChat
20 Weibo
21 WhatsApp
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"
        }
    ]