Trulioo GlobalGateway Developer Portal

Welcome to the Trulioo GlobalGateway developer hub. You'll find comprehensive guides and documentation to help you start working with GlobalGateway as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Getting Started with GlobalGateway

Welcome to the Trulioo GlobalGateway developer portal. This portal hosts documentation for the whole developer lifecycle as outlined below, so that you can refer to it at any stage of your integration with GlobalGatewayGlobalGateway - Trulioo provides a collection of API methods to help you build business processes powered by the GlobalGateway Normalized API..

GlobalGateway provides secure access to over 400 data sources worldwide so you can verify 5 billion people and 250 million business entities in real-time. Onboard customers faster and easier with robust API documentation, trusted and vetted data sources, normalized data fields, and an easy RESTful API integration.

Developers WorkflowDevelopers Workflow

Developers Workflow

1 Starting Out

Keys & Authentication

Before testing the GlobalGateway API the most important thing you will need is credentials. Follow the steps in Keys and Authentication to get set up.

Enterprise Developer Portal Structure

This portal has been arranged to make the information you need as easy to find as possible. The navigation bar to the left shows the main product offerings of GlobalGateway. Every product section has the following:

API Reference

The API reference contains full documentation of all the endpoints for the GlobalGateway API, as well as an interactive web console to make test calls.

Technical Overview

The GlobalGateway Normalized API (NAPINAPI - Normalized API - a loosely coupled API; fields may be added to our services and responses as the API evolves, and a client must be able to safely ignore fields and data that are not expected. NAPI can help automate your business processes by performing tasks such as Identity Verification, Business Verification, Document Verification and AML Watchlist.) is a stateless web service based on RESTful architecture. The production endpoint is supported solely on HTTPS. All requests to the production endpoint need to be SSL/TLS compliant. Please ensure you have the correct base URLbase URL - This is either or depending on your account set up. All API calls, for example, {baseURL}/connection/v1/sayhello/ follow the same syntax and act the same between both base URLs. If you are unsure which base URL you should be using to access Trulioo's API, please contact [email protected] for the API.

Request and response body data are required to be in the standard JSON format. The output JSON should not be treated as fixed or as a schema. New fields may be added as the API evolves. Clients must not rely on the order in which data appears in JSON service responses and should be resilient to the reordering of fields within a JSON object. The Content-Type header value must be set to "application/json; charset=utf-8".

We use built-in HTTP features, such as HTTP authentication, errors, and verbs which are understood by standard HTTP clients.

For faster response times, include an Accept-Encoding header with a value of "gzip, deflate" and responses will be gzipped.

2 Making a Test Verification


If this is your first integration with GlobalGateway you should have access to a demo account, which is your sandbox environment. If you are unsure whether you have a sandbox environment, or how to access it, please contact support.

The sandbox environment is intended to let you get a feel for how the GlobalGateway API works, but does not perform live transactions against real data. Rather, it checks the given identity against a static test database hosted on GlobalGateway. For this reason you will need to use a test entity.

Test Entities

A test entity is a dummy identity provided by Trulioo, which matches a record in the GlobalGateway test database. Test entities can be safely verified in demo accounts without having any impact on real people or data.

There are two ways to obtain test entity data. The first is to log into the GlobalGateway portal, select "Verify" in the left-hand menu, choose any country, hit the "Populate" button, and copy the test data from the UI. The second is to make a GlobalGateway API call to Get Test Entities.

Quick Starts

These quick start guides will walk you through the process of your first verification:

If you are unsure which one to pick, you should probably start with identity verification, which is the basic KYC ("Know Your Customer") solution for verifying individuals.

3 Building Your Production Integration

Integration & Best Practices

Once you've read the quickstart guides, you can dig deeper with the integration best practices guide. This guide gives an idea of what your integration with GlobalGateway might look in production and lists best practices that Trulioo recommends for a successful integration.

As you build your integration and get ready for go-live, Trulioo recommends working closely with the support team to ensure you are set up for success. You will receive any assistance you need to guarantee that your integration goes as smoothly as possible.

Live API Credentials

Once you're satisfied with your initial test of the API, you can contact Trulioo support to receive live API credentials. This will allow you to begin checking identities against live datasources, rather than the GlobalGateway hard-coded test entities.

Go Live

The support team will be there every step of the way to organize a go live date and ensure you have a seamless launch.

4 Continued Support

Your journey with GlobalGateway doesn't need to stop with one successful integration.
For example, you might want to incorporate Mobile ID or Global AML Watchlist into your application, or learn more about document verification.

At any point, if you're thinking of expanding or updating your integrations, you can refer back to the API Reference. It provides detailed documentation for all the endpoints for the GlobalGateway API, and has an interactive web console so you can make your initial test calls straight from the browser.

For any other questions or requests, contact Trulioo's support team at [email protected].

Updated 7 months ago

Getting Started with GlobalGateway

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.