Respond to an RFI

Submits the merchant's answers to the questions in a Request for Information (RFI). Each element in answers corresponds to one question returned by Retrieve an RFI. Provide files for ATTACHMENT questions, text for TEXT questions, and textList for TEXTLIST questions, according to each question's answerType. Upload any files first via Upload a File and use the returned id as fileId. This is a stateful action. It requires the RFI to be in ACTION_REQUIRED status and advances it to ANSWERED. Repeated calls when the status is not ACTION_REQUIRED return RFI_INVALID_STATUS without side effects, so the operation is idempotent.
Request Parameters
idstring
required
Unique identifier of the RFI to respond to.
answersarray
required
List of answers; each element corresponds to one question in the RFI's questions array. Provide 1–50 elements.
Show child parametersShow child parameters
Response Parameters
resultResult
See Result.
idstring
Unique identifier of the RFI.
statusstring
Status of the RFI after the operation. Fixed to ANSWERED on a successful response. See RfiStatus.
createdAtdatetime
Time the RFI was created. ISO 8601 UTC format (ending with Z).
updatedAtdatetime
Time the RFI was updated by this operation. ISO 8601 UTC format (ending with Z).
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
RFI_NOT_FOUNDFThe requested RFI does not exist. Please verify the id and retry.Check the `id` matches an existing RFI.
RFI_INVALID_STATUSFThe RFI is not in ACTION_REQUIRED status and cannot be responded to.Retrieve the RFI and confirm its `status` is `ACTION_REQUIRED` before responding.
AUTHORIZATION_NOT_EXISTFYou do not have permission to operate this RFI. Please verify your account-id.Check the `account-id` header is linked to the calling client.
PARAM_ILLEGALFThe request parameters are invalid.Check each answer provides the field required by its question's `answerType` (`files` / `text` / `textList`).
PROCESS_FAILFA general business failure occurred.Retry later; if it persists, contact WorldFirst support.
Definition
POST /api/open/v1/rfis/respond
Request
{
"id": "20260818191210001360300000****1",
"answers": [
  {
    "questionId": "20260818191210001370300000****1",
    "text": "Example Trading Ltd."
  },
  {
    "questionId": "20260818191210001370300000****2",
    "files": [
      {
        "fileId": "BIZ_ENTERPRISE_FILE_GENERAL_DOCUMENT_20260731191530000024978000****4",
        "fileName": "certificate_of_incorporation.jpg"
      }
    ]
  }
]
}
Response
{
"result": {
  "resultStatus": "S",
  "resultCode": "SUCCESS",
  "resultMessage": "success"
},
"id": "20260818191210001360300000****1",
"status": "ANSWERED",
"createdAt": "2026-08-18T12:37:05Z",
"updatedAt": "2026-08-18T12:44:36Z"
}