Step 2: Test Authentication

Once you have the username and password for your 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. account, you can use the Test Authentication endpoint to check that they're working. The only thing you need to provide in this request is an authorization header, as shown below. To generate the "ACCESS_TOKEN" portion of the header, combine your username and password into a string username:password and run the resulting string through Base64 encryption. Alternatively, you can use a program such as SOAPUI or Postman to construct the authorization header for you.


GET <<endpoint>>/connection/v1/testauthentication
Authorization: Basic ACCESS_TOKEN
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
var truliooClient = new TruliooApiClient("JoeNapoli_API_Demo", "05uZuPRCyPi!6");
var responseString = await truliooClient.Connection
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
ApiClient apiClient = new ApiClient();
ConnectionApi connectionClient = new ConnectionApi(apiClient);

String testResult = connectionClient.testAuthentication();

connectionClient.testAuthenticationAsync(new ApiCallback<String>() {
    public void onFailure(ApiException e, int statusCode, Map<String, List<String>> responseHeaders) {
        Logger.getLogger(SdkJavaV1Sample.class.getName()).log(Level.SEVERE, null, e);
    public void onSuccess(String result, int statusCode, , Map<String, List<String>> responseHeaders) {
    public void onUploadProgress(long bytesWritten, long contentLength, boolean done) {
        //To change body of generated methods, choose Tools | Templates.
    public void onDownloadProgress(long bytesRead, long contentLength, boolean done) {
        //To change body of generated methods, choose Tools | Templates.


Hello JoeNapoli_API_Demo

You should receive a response containing your username, as shown above. The most common reasons for an error response are:

  • The authorization header isn't set properly. It should be a Base64Base64 - Base64 is a group of similar binary-to-text encoding schemes that represent binary data in an ASCII string format by translating it into a radix-64 representation. Trulioo uses it for our ACCESS_TOKEN and encoding our images for document verification. - encrypted Basic AuthenticationBasic Authentication - Basic Authentication uses standard fields in the HTTPS request header to avoid the need for handshakes. The header is "Authorization: Basic ACCESS_TOKEN” Where ACCESS_TOKEN is “username:password". header.
  • The spelling is incorrect.
  • The wrong credentials were used.

Ensure that you are setting the authorization header correctly, using the right username/password without any typos.


Error Messages

If you aren't receiving a successful response of the string you sent as a parameter visit our Error Page here to diagnose.


Frequently Asked Questions

1. Do I need to get my IP address whitelisted?

No, Global Gateway only uses Basic Authentication where the Username and Password are combined into a string "username:password". The resulting string is then encoded. Reach out to [email protected] for your API credentials.

Did this page help you?