Information Requests (RFIs)

Overview

When transactions are flagged as high-risk, they are marked as pending on our system. Our compliance team will review transactions and may ask a customer for further information on a transaction to better understand the nature of the request. If an administrator needs more details to make this decision, they can send an information request (RFI) to the customer. This module will enable API users to retrieve information requests and respond with supporting documents and information.

When a information request is issued, API users will receive a callback notification. Similarly, when a request is updated (either being accepted, rejected, or requires more information), another callback request is sent.

Endpoints in this Section:

  1. List Information Requests - Retrieves a list of information requests (RFIs). Optional filters can be applied to narrow down the list by customer.

  2. Get Information Request Details - Retrieves detailed information about a specific information request using its unique ID.

  3. Submit Information Request - Allows a customer to submit information and documents in response to an RFI.


List Information Requests

Retrieves a list of information requests (RFIs). Optional filters can be applied to narrow down the list by customer.

  • Endpoint: /api/v1/customer/informationrequests/getinformationrequestlist

  • Method: GET

  • Response Format: application/json

GET Query Parameters

Example Success Response

{
    "id": 14152,
    "details": [
       {
            "id": 1004,
            "status": "More Information Required",
            "addDate": "2024-03-20T12:29:16.023",
            "expiryDate": "2024-03-27T12:29:16.023",
            "orderType": "OUT",
            "name": "Addison Payee",
            "reference": "United States Dollar: CTX31165",
            "amount": -20.000000000000000000,
            "currencySymbol": "$",
            "assetCode": "USD"
        },

    ],
    "pageSize": 10,
    "pageNumber": 1,
    "numberOfPages": 2,
    "status": "1",
    "errors": []
}
	

Get Information Request Details

Retrieves detailed information about a specific information request using its unique ID.

  • Endpoint: /api/v1/customer/informationrequests/ getinformationrequestdetails

  • Method: GET

  • Response Format: application/json

GET Query Parameters

Example Success Response

{
    "id": 1004,
    "details": {
        "id": 1004,
        "status": "More Information Required",
        "orderType": "OUT",
        "name": "Addison Payee",
        "currencySymbol": "$",
        "assetCode": "USD",
        "amount": -20.000000000000000000,
        "description": "string",
        "responseFormGuid": "F0A88644-A105-4CF1-ACE0-B570F1411783",
        "supportingInformation": null,
        "supportingDocumentUploads": null
    },
    "status": "1",
    "errors": []
}

Submit Information Request

Allows a customer to submit information and documents in response to an RFI.

  • Endpoint: /api/v1/customer/informationrequests/submitinformationrequest

  • Method: POST

  • Request format: form-data

  • Response format: application/json

Request Body

CustomerAssetAccountsTransactionsInformationRequestsId
1004

ResponseFormGuid
BCBE8BF9-1171-4F60-B434-694C19BFDD9F

SupportingInformation
Example supporting information

SupportingDocumentUploads
/C:/Path/To/File/dummy.pdf

SupportingDocumentUploads
/C:/ Path/To/File/dummy_2.pdf	

Example Success Response

{
  "id": 1046,
  "status": "1",
  "errors": []
}	

Last updated