Skip to main content

Initiating a KYC Screening

Swagger docs

Screening API endpoints

Retrieving screening token

To initiate a user screening, first create a screening token by making an HTTP POST request to:


curl --location --request POST '' --header 'Authorization: Bearer {your_access_token}'
{"token": "bf42e9f1-9af8-4a6b-a1fd-9440f1fe9bfd"}

For each unique user account in your system, you should issue and keep only one screening token - treat it as each user's unique GlobalPass Screening ID. Therefore, when propmpting user to repeat a widget session, or when initializing identity and address screening modes of the same unique user, make sure to provide the same unique screening token issued for the unique user.

Initiating GlobalPass Widget

After getting the screening token, provide it to our javascript widget that you have pasted into your frontend.

Widget source URLs:

Your page should look something like this:

<script src=""></script>
<div id="widgetScreening"></div>
elementId: "widgetScreening",
token: "bf42e9f1-9af8-4a6b-a1fd-9440f1fe9bfd",
redirectUri: "",
externalId: "your-customer-ID",
mode: "Identity",
language: "en"

Widget initialization properties

elementIdHTML DOM element that the widget will attach to
tokenscreening token, retrieved as per instructions above
redirectUriyour custom widget redirect URI (optional)
externalIdcustomer ID of the unique user from your system that will reflect on the GlobalPass report (optional)
modeIdentity (identity documents, biometrics, AML) or Address (proof of address, geolocation) (required in Split Flow only)
languagepre-selected language code (optional)

Specifying mode is required if you wish to use Split Flow approach. If Regular Flow is used – do not specify mode. Before starting integration, contact GlobalPass support to find out more about the differences and inform which approach you wish to use, as appropriate set-up on GlobalPass end will be required as well.

Specifying required language

By default, widget is displayed in browser's language, if it is supported. If browser's language is not supported, widget is displayed in English. If required, you can pre-select a specific locale for the widget instead, by specifying one of the supported language codes below.

  • en - English
  • de - German
  • es-MX - Spanish
  • it - Italian
  • lt - Lithuanian
  • pt-BR - Portuguese
  • ru - Russian
  • ar - Arabic
  • zh-CN - Chinese Simplified