Retrieve an RFI
Retrieves a single Request for Information (RFI) by its ID, including the full questions array with the detailed information the merchant must provide. This is the only endpoint that returns question details; List RFIs and webhook notifications return summaries without questions. To retrieve an RFI for a connected account, a platform passes the target account in the account-id request header. WorldFirst validates that the account-id is linked to the caller; otherwise it returns AUTHORIZATION_NOT_EXIST. See Authentication.
Request Parameters
idstring
required
Unique identifier of the RFI to retrieve. This is the only accepted field in the request body.
Response Parameters
resultResult
See Result.
idstring
Unique identifier of the RFI.
accountIdstring
ID of the account the RFI belongs to.
rfiTypestring
Type of the RFI, indicating the business scenario it originates from. See RfiType.
statusstring
Current status of the RFI. See RfiStatus.
instructionstring
Human-readable, top-level instruction describing what the merchant needs to provide. Returned only when the RFI has a top-level instruction.
expiresAtdatetime
Deadline for answering the RFI; the RFI is automatically marked EXPIRED once passed. ISO 8601 UTC format (ending with Z). Returned only when the RFI has a deadline.
questionsarray
List of questions (the requested information) the merchant must answer. Returned only when the RFI has question details.
createdAtdatetime
Time the RFI was created. ISO 8601 UTC format (ending with Z).
updatedAtdatetime
Time the RFI was last updated. ISO 8601 UTC format (ending with Z).
Error Codes
Definition
POST /api/open/v1/rfis/queryRequest
{
"id": "20260818191210001360300000****1"
}Response
{
"result": {
"resultStatus": "S",
"resultCode": "SUCCESS",
"resultMessage": "success"
},
"id": "20260818191210001360300000****1",
"accountId": "21201203489****3",
"rfiType": "KYC_ONGOING_CDD_RFI",
"status": "CLOSED",
"instruction": "Please re-confirm your company name and upload the certificate of incorporation.",
"questions": [
{
"id": "20260818191210001370300000****1",
"auditKey": "basicInformation.companyName.value",
"description": "The document has expired",
"answerType": "TEXT",
"required": true
},
{
"id": "20260818191210001370300000****2",
"auditKey": "basicInformation.companyCertificateOfIncorporation",
"description": "The document is mismatched",
"answerType": "ATTACHMENT",
"required": true
}
],
"createdAt": "2026-08-18T12:37:05Z",
"updatedAt": "2026-08-19T02:53:31Z"
}