Onboarding Check

GlobalGateway Watchlist Request

👍

GlobalGateway Watchlist service is integrated into Trulioo's Identity services. Customers using our KYC or KYB identity solutions do not need to make any changes to their request structure except to add the VerboseMode parameter.

Prerequisites

  • Before you get started, make sure you have either a NAPI user account or a GlobalGateway Portal account.
  • You have existing knowledge of the GlobalGateway API.
  • You have tested your credentials using the Test Authentication call.
  • You are aware of what fields and countries you are configured for from the Integration Guide

API Endpoint

For ease of integration, our Watchlist product is integrated into the same Global Gateway endpoint as our KYC and KYB products.

https://api.globaldatacompany.com/verifications/v1/verify

Sample API Request

{
"DataFields": {
    "PersonInfo": {
        "FirstGivenName": "Vladimir",
        "FirstSurName": "Putin",
        "DayOfBirth": 7,
        "MonthOfBirth": 10,
        "YearOfBirth": 1952
    }
},
"AcceptTruliooTermsAndConditions": true,
"CountryCode": "US",
"VerboseMode": "True"
}
POST /verifications/v1/verify HTTP/1.1
Host: api.globaldatacompany.com
Authorization: Basic ACCESS_TOKEN
Content-Type: application/json

{
"DataFields": {
    "PersonInfo": {
        "FirstGivenName": "Vladimir",
        "FirstSurName": "Putin",
        "DayOfBirth": 7,
        "MonthOfBirth": 10,
        "YearOfBirth": 1952
    }
},
"AcceptTruliooTermsAndConditions": true,
"CountryCode": "US",
"VerboseMode": "True"
}
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n\"DataFields\": {\r\n    \"PersonInfo\": {\r\n        \"FirstGivenName\": \"Vladimir\",\r\n        \"FirstSurName\": \"Putin\",\r\n        \"DayOfBirth\": 7,\r\n        \"MonthOfBirth\": 10,\r\n        \"YearOfBirth\": 1952\r\n    }\r\n},\r\n\"AcceptTruliooTermsAndConditions\": true,\r\n\"CountryCode\": \"US\",\r\n\"VerboseMode\": \"True\"\r\n}");
Request request = new Request.Builder()
  .url("https://api.globaldatacompany.com/verifications/v1/verify")
  .method("POST", body)
  .addHeader("Authorization", "Basic ACCESS_TOKEN")
  .build();
Response response = client.newCall(request).execute();

GlobalGateway Watchlist Response

🚧

To see the WatchlistHitDetails Object you must set VerboseMode:true in the request.

Sample API Response

{
    "TransactionID": "d932a341-f367-40aa-9963-ab9317f2ffd7",
    "UploadedDt": "2022-05-02T16:41:42",
    "CountryCode": "US",
    "ProductName": "Identity Verification",
    "Record": {
        "TransactionRecordID": "202ae996-5d61-8841-35e6-eab0028e8bc1",
        "RecordStatus": "nomatch",
        "DatasourceResults": [
            {
                "DatasourceName": "Advanced Watchlist",
                "DatasourceFields": [],
                "AppendedFields": [
                    {
                        "FieldName": "WatchlistState",
                        "Data": "Potential Hit"
                    },
                    {
                        "FieldName": "WatchlistData",
                        "Data": {
                            "num_WL_hits": 2,
                            "num_AM_hits": 2,
                            "num_PEP_hits": 1
                        }
                    },
                    {
                        "FieldName": "WatchlistHitDetails",
                        "Data": {
                            "WL_results": [
                                {
                                    "score": 1.0,
                                    "subjectMatched": "Vladimir Vladimirovich Putin",
                                    "dataOfBirth": "07 Oct 1952",
                                    "nationality": "Nationality: Russia | Citizenship: Russia",
                                    "sourceListType": "FEDERAL EXCLUSION - Specially Designated Nationals [SDN] List",
                                    "sourceRegion": "North America",
                                    "remarks": null,
                                    "caution": "As part of its enforcement efforts, OFAC publishes a list of individuals and companies owned or controlled by, or acting for or on behalf of, targeted countries. It also lists individuals, groups, and entities, such as terrorists and narcotics traffickers designated under programs that are not country-specific. Collectively, such individuals and companies are called \"Specially Designated Nationals\" or \"SDNs.\" Their assets are blocked and U.S. persons are generally prohibited from dealing with them.",
                                    "URL": "https://home.treasury.gov/policy-issues/financial-sanctions/specially-designated-nationals-and-blocked-persons-list-sdn-human-readable-lists"
                                },
                                {
                                    "score": 1.0,
                                    "subjectMatched": "Vladimir Vladimirovich Putin",
                                    "dataOfBirth": "07/10/1952",
                                    "nationality": "Russia",
                                    "sourceListType": "EU Consolidated List",
                                    "sourceRegion": "European Union",
                                    "remarks": "Listed On: 25/02/2022 | UK Sanctions List Date Designated: 25/02/2022 | Last Updated: 25/02/2022",
                                    "caution": "(UK Sanctions List Ref):RUS0251 (UK Statement of Reasons):Vladimir Vladimirovich Putin is the President of the Russian Federation, carrying ultimate authority for the policy of the Russian government and Russian armed forces. In February 2022, Putin ordered Russian military forces to launch an invasion of Ukraine, undermining and threatening the territorial integrity, sovereignty or independence of Ukraine. (Gender):Male",
                                    "URL": "https://www.gov.uk/government/publications/financial-sanctions-consolidated-list-of-targets/consolidated-list-of-targets"
                                }
                            ],
                            "AM_results": [
                               {
                                    "score": 1.0,
                                    "subjectMatched": "Vladimir Putin",
                                    "text": "As the ruble’s official exchange rate parts ways with its value on the street, dollars are becoming hard to find. As the ruble’s official exchange rate parts ways with its value on the street, dollars are becoming hard to find. (AP Photo/Alexander Zemlianichenko) AS THE RUBLE’S official exchange rate parts ways with its value on the street, dollars are becoming hard to find. For Boris, a doctor based in Moscow, the search got so desperate that he pondered a high-tech, and seemingly improbable, black-market scheme that a friend was pushing. After interacting with a bot via messenger app, his acquaintance transferred Rubles electronically to receive a barcode that he scanned to access a safe storage box at a Moscow mall. The 1,000 euros ($1,040) he’d ordered were sitting inside. “Banks either have no foreign currency, or, if they do, they sell it at a bad rate,” said Boris, 35, who requested that his surname not be used due to the sensitivity of the matter. Still, “you’d have to really trust the system to do that. I wouldn’t risk it,” he said. Vladimir Putin’s war against Ukraine has put the economy on track for its sharpest contraction in decades. But the Russian currency is up about 25% against the US Dollar since the invasion began, giving it the incongruous title of best performer globally. While that’s allowed Putin to brag that the sanctions “Blitzkrieg” of the West has failed, ordinary Russians can’t take advantage of the currency’s strength. Oil flows and capital controls have warped the official rate, and the Ruble is around 20% weaker at exchange points and on the black market – reminding many Russians of its Soviet predecessor. “It’s like trying to show the Soviet Union is beating America by waving a copy of the Izvestia newspaper in someone’s face in 1982 and saying: ‘Look, the Kollar is worth only 64 Kopecks!”‘ said Sergey Khestanov, a Moscow-based professor of finance and banking and advisor to the chief of executive of the Otkritie brokerage. “I’d agree – if anyone could actually buy a dollar for 64 Kopecks.” Under the central bank’s latest rules, lenders can only sell dollars and euros they’ve received since April 9. Individuals can withdraw hard currency, but only from accounts opened before March 9 and not more than the equivalent of $10,000 before September. The limit for physically carrying out cash when going abroad is also $10,000. In an echo of the illegal money changers operating in the late Soviet period, middlemen working in cahoots with bank employees lure buyers with rates that beat the official ones posted in currency exchanges. As in the past, there’s always a danger of walking away with counterfeit notes, according to Boris. He eventually opted for the middleman and paid 15% more than the official rate to buy $2,000 for his his ex-wife and children. They needed cash on hand for a holiday in Turkey since sanctions stopped Russian-issued credit cards from working abroad. On Monday, banks were selling Dollars on average for 20% more than the Ruble price quoted on the Moscow Exchange, according to a survey of about 70 Moscow banks and exchange points by the RBC and Banki.ru financial websites. Black-market rates shown in currency exchange channels on messenger apps ranged from 73 Rubles to 75 Rubles in Moscow, while the Ruble closed at 63.4 per Dollar on Monday on the Moscow Exchange. That may be a far cry from the giant gap between official and black market rates in a country like Zimbabwe, but the discrepancy in Russia reflects the reality of an economy that’s never been this isolated in its post-Soviet history. Sanctions severing Russia from the global banking system and emergency capital controls at home are choking off imports and making large-scale capital flight impossible. At the same time, international penalties have been carefully crafted to allow countries to continue buying Russia’s oil, gas and other commodities, keeping billions of Dollars flowing into Kremlin coffers each week. Defending the lopsided US approach, Secretary of State Antony Blinken dismissed the Ruble’s rally at the start of April as “not sustainable.” The currency has appreciated 30% since Blinken spoke, but Tatha Ghose at Commerzbank agrees with him. “The exchange rate no longer has any forward-looking component because sanctions and capital controls prevent meaningful capital flow,” Ghose wrote in a report. The Ruble is moved by “day-to-day current demand and supply for trading those items which are still possible to export and import.” Even the Bank of Russia admitted in its latest monetary report that sanctions have essentially turned the rate into a blunt expression of the country’s trade balance. As an embargo on oil and gas by European governments kicks in by late 2022, Ghose predicts the Ruble will slump 10% by year-end and a further 20% by the end of 2023. To be sure, some Ruble weakness would be welcomed by the Finance Ministry. The Dollar price of Russia’s main Urals blend of crude oil is falling and the currency’s appreciation means the government collects ever fewer Rubles per barrel, imperiling its budget revenue targets. Russia will be left with “virtually no cushion for the economic slump and the financial pressures of the protracted war in Ukraine,” TS Lombard’s Christopher Granville and Madina Khrustaleva wrote in a note. Back on the Dollar trail in Moscow, Sofya, 22, a student, managed to buy $550 Dollars at an official exchange point on her third attempt. She’s getting the cash together to take to her boyfriend, who she packed off to Prague amid constant speculation Putin will announce a national call-up as the war drags on. Her tip: set out early and contact the banks in advance to avoid disappointment. “The exchange rate was bad, way higher than the official rate,” she said. “But at least they weren’t charging a 30% commission like they were in February.” Related Video: !function(e,t,r){let n;if(e.getElementById(r))return;const a=e.getElementsByTagName(“script”)[0];n=e.createElement(“script”),n.id=r,n.defer=!0,n.src=”https://playback.oovvuu.media/player/v1.js”,a.parentNode.insertBefore(n,a)}(document,0,”oovvuu-player-sdk”); WASHINGTON POST",
                                    "URL": "https://www.dfa.co.za/international-news/putin-sends-russians-on-wild-hunt-for-dollars-in-the-black-market-cd74697c-eaf9-4604-9cc0-53a76ddad87e/"
                               }, 
                               {
                                    "score": 1.0,
                                    "subjectMatched": "Vladimir Putin",
                                    "text": "KYIV: The European Commission will provide a clear signal next week on Ukraine's EU candidate status bid, its chief Ursula von der Leyen said Saturday (Jun 11), as fighting raged in the east and south of the country. Making a surprise visit to Kyiv, von der Leyen said talks she held with Ukrainian President Volodymyr Zelenskyy \"will enable us to finalise our assessment by the end of next week\" - the first time the bloc has publicly given a timing. Zelenskyy has been pressing for rapid admission into the European Union as a way of reducing Ukraine's geopolitical vulnerability, which was brutally exposed by Russia's Feb 24 invasion. But officials and leaders in the bloc caution that, even with candidacy status, actual EU membership could take years or even decades. Von der Leyen, appearing alongside Zelenskyy during her second visit to Kyiv since the war began, did not hold out any promises, noting further reforms were needed. For his part, the Ukrainian president warned it was a \"decisive time\" for his country and the EU. \"Russia wants to ruin the European unity, wants to leave Europe divided and wants to leave it weak. The entire Europe is a target for Russia. Ukraine is only the first stage in this aggression, in these plans.\" Despite reservations among some member states, EU leaders are expected to approve Ukraine's candidate status at a summit on Jun 23-24, though with stern conditions attached. CRISIS AND FAMINE The EU and the United States have strongly backed Ukraine, sending weapons and cash to help it see off Russian forces, and punishing Moscow with unprecedented economic sanctions. Zelenskyy has urged them on during a continuous diplomatic offensive that has seen him appearing via video link at parliaments and summits around the world. On Saturday, he warned the Shangri-La Dialogue security summit in Singapore of the dangers of a global food crisis posed by Russia's blockade of Ukraine's Black Sea ports. He warned of \"an acute and severe food crisis and famine\", adding that the \"shortage of foodstuffs will inexorably lead to political chaos\" - all of it \"the direct consequence of the acts of the Russian state\". Before the war, Ukraine was the world's top producer of sunflower oil and a major wheat exporter, but millions of tonnes of grain exports remain trapped due to the blockade. Speaking to delegates including Pentagon chief Lloyd Austin and China's defence minister, Zelenskyy urged international pressure to end the blockade. Kyiv is in discussion with the UN, Turkey and other countries to open a way to allow the grain exports, and Zelensky said the talks are focused on the \"format\" of the corridor. \"DEVASTATE EVERY CITY\" After withdrawing from the capital Kyiv, Russian forces have concentrated their firepower on the eastern Donbas region and the south. They continued their bombardment overnight Friday-Saturday of towns and villages around Kharkiv and in the Donbas regions of Lugansk and Donetsk, Zelenskyy's office said. \"Russia wants to devastate every city in the Donbas, every single one, without exaggeration,\" the president said in his nightly address Friday. Moscow has particularly focused on the key eastern industrial city of Severodonetsk, which Lugansk regional governor Sergiy Gaiday said Saturday was \"ruined\" by Russian forces. \"This is their tactics - people are not needed, the infrastructure is not needed, houses are not needed, everything should be simply ruined,\" he said in an interview posted on his Telegram channel. He declined to estimate the number of civilian victims, but said he expected the figure would be \"enormous and terrible\". \"Many people were buried in front of their houses' entrances. A shell from heavy artillery is tearing people up into bits and pieces,\" he said. He added: \"They lie like this for a day, three or four. It is impossible to take them out because there is constant shelling.\" In the Mykolaiv region near the front line in the south, regional governor Vitaliy Kim stressed the urgent need for international military assistance. \"Russia's army is more powerful, they have a lot of artillery and ammo. For now, this is a war of artillery... and we are out of ammo,\" he said. British Defence Secretary Ben Wallace visited Ukraine on Friday, where Zelenskyy thanked London for its support. Following Washington's lead, Britain announced the delivery of multiple rocket launcher systems - with a range of about 80km, slightly superior than the Russian systems. It was not clear when Ukraine will be able to start using them. RUSSIAN PASSPORTS ISSUED In areas now controlled by its forces, Moscow has sought to impose its authority. Authorities in the occupied city of Kherson in southern Ukraine handed out Russian passports to local residents for the first time on Saturday, news agencies reported. Russia's TASS agency said 23 Kherson residents received a Russian passport at a ceremony through a \"simplified procedure\" facilitated by a decree signed by Russian President Vladimir Putin in May. Ukraine has denounced the move as a \"flagrant violation\" of its territorial integrity, saying Putin's decree was \"legally void\". It follows the introduction last month in the Kherson region of the Russian ruble as an official currency alongside the Ukrainian hryvnia.",
                                    "URL": "https://www.channelnewsasia.com/world/ukraine-european-union-membership-ursula-von-der-leyen-volodymyr-zelenskyy-2741656"
                                }
                            ],
                            "PEP_results": [
                                {
                                    "score": 1.0,
                                    "name": "Vladimir Putin",
                                    "country": "Soviet Union",
                                    "dateOfBirth": "1952-10-07",
                                    "professionalHistory": [
                                        "President of Russia",
                                        "Director of the Federal Security Service",
                                        "Saint Petersburg City Administration",
                                        "Presidential Administration of Russia",
                                        "Prime Minister of Russia",
                                        "Deputy Chairman of the Government of the Russian Federation",
                                        "Presidential Property Management Department",
                                        "chairperson",
                                        "Supreme Commander-in-Chief of the Armed Forces of the Russian Federation",
                                        "Acting President of Russia",
                                        "Chairman of the Council of CIS Heads of State",
                                        "intelligence agent",
                                        "politician",
                                        "jurist",
                                        "judoka",
                                        "autobiographer",
                                        "economist",
                                        "sambo fighter",
                                        "stunt performer",
                                        "coach",
                                        "military personnel",
                                        "lawyer"
                                    ]
                                }
                            ]
                        }
                    }
                ],
                "Errors": [],
                "FieldGroups": []
            }
        ],
        "Errors": [],
        "Rule": {
            "RuleName": "Category 3 KYC v3",
            "Note": "Match(FamilyAndGivenInitial, DOB) or Match(FamilyAndGivenInitial, FullAddress) or Match(FamilyAndGivenInitial, ID) MiddleName Ignored"
        }
    },
    "Errors": []
}

Did this page help you?