Step 5: Download Document

GlobalGateway provides customers with the ability to request various documents such as Shareholder documents, Articles of Association, Financial information documents etc. from the government registry, in real time.

How does document requesting work?

  1. Customers request the Document at the time of the verification. The availability of documents for download from a datasource needs to be checked as part of the Verify request. If you are interested in obtaining this information for a business you are verifying, the Business block of your Verify response needs to include the fieldName of the document as true.
    For a full list of available documents and the associated fieldNames, refer to Document Availability
           - "ShareholderListDocument": true,      AND / OR
           - "FinancialInformationDocument": true
  1. If the documents are:
    a. Available for the specified company, GlobalGateway will request them from the Government Registry.
    b. Not available for the specified company, GlobalGateway will not request anything from the Government Registry.

  2. Subsequently, to use the Download Document method, you will need to use the transactionRecordId from the previous Verify request along with the fieldName from Document Availability. Once the document request is complete, GlobalGateway will provide the Base64 string for the document .

Request

GET <<endpoint>>/v3/verifications/documentdownload/{transactionRecordID}/{fieldName}
Authorization: OAuth

🚧

Important:

Trulioo provides multiple global and regional endpoints. Please choose the correct endpoint based on your business use case and your regulatory and compliance requirements. See the full list here.

Response

This endpoint will return a media/pdf/Base64 response of the document being requested.

📘

Frequently Asked Questions

1. Are all documents available for download immediately?

Some datasources may not respond immediately. In such cases, you can configure a callback URL and the response will be updated once the document is available for download.

2. Can the processing time for document requests be sped up?

No, GlobalGateway only handles the request and response on behalf of customers. These restrictions are provided by the Government Registry.