GlobalGateway provides customers with the ability to request shareholder documents and financial information documents from the government registry, in real time.
How does document requesting work?
- Customers request the Shareholder Document and/or the Financial Information 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 following optional values:
- "ShareholderListDocument": true, AND / OR
- "FinancialInformationDocument": true
-
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. -
Subsequently, to use the [Download Document] (ref:document-download) method, you will need to use the transactionRecordId from the previous Verify request along with the fieldName which could be "DocumentUrl". Once the document request is complete, GlobalGateway will provide the Document URL to customers to download the document as a PDF.
Request
GET <<endpoint>>/verifications/v1/documentdownload/transactionRecordId/fieldName
Authorization: Basic ACCESS_TOKEN
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. You can find more information on the Multi-Region Hosting page.
Response
This endpoint will return a media/pdf 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.