Developer Docs
WebsiteDashboard
GuidesAPI ReferenceHelp
PaymentProvider KYC

Get an RFI

GET
/openapi/v1/customers/provider-kyc/rfis/{rfiId}

Gets one RFI with its questions.

Authorization

bearerAuth
headerAuthorizationBearer <token>

The access_token obtained from POST /oauth2/token. Header format: Authorization: Bearer {accessToken}.

Path Parameters

rfiId*string

RFI ID assigned by the provider.

Query Parameters

customerUid*string

UID that the caller defines for the customer. Submitting KYB creates it at the provider.

Header Parameters

X-Channel-Provider*string

Provider identifier. Provider KYC supports only LEGEND now.

Response Body

The RFI detail.

application/json
  1. response
code?integer

Business status code

message?string
traceId?string

Request trace ID. Provide it when you contact technical support

data?

Request for information (RFI) raised by the provider.

Example Request
curl -X GET 'https://api.test.stabofx.com/openapi/v1/customers/provider-kyc/rfis/rfc_xxx?customerUid=cust_example_001' \  -H 'X-Channel-Provider: LEGEND'
Example Response
{  "code": 200,  "message": "OK",  "traceId": "trace-uuid-string",  "data": {    "rfiId": "rfc_xxx",    "customerUid": "cust_example_001",    "status": "ACTION_REQUIRED",    "restrictions": [      "swap",      "fiat_withdrawal"    ],    "expiresAt": "2026-11-20T00:00:00+08:00",    "updatedAt": "2026-11-10T10:00:00+08:00",    "questions": [      {        "questionId": "rfq_text",        "replyType": "TEXT",        "questionText": "Describe the main business of the company.",        "required": true,        "maxLength": 500      },      {        "questionId": "rfq_doc",        "replyType": "DOC",        "questionText": "Upload the latest bank statement.",        "required": true,        "fileRequired": true,        "maxFiles": 3      },      {        "questionId": "rfq_text_doc",        "replyType": "TEXT_DOC",        "questionText": "Explain the source of the last large deposit and upload proof.",        "required": true,        "fileRequired": true,        "maxLength": 500,        "maxFiles": 2      },      {        "questionId": "rfq_checkbox",        "replyType": "CHECKBOX",        "questionText": "Select the expected payment purposes.",        "options": [          "Supplier payments",          "Payroll",          "Others"        ],        "required": true      },      {        "questionId": "rfq_idv",        "replyType": "IDV",        "questionText": "Complete identity verification for the director.",        "required": true,        "idvStarted": false      }    ]  }}

List RFIs GET

Lists the requests for information (RFIs) the provider raised for the customer. The list does not include questions. Get an RFI to see them.

Create an IDV session POST

Creates an identity verification session for an IDV question of an RFI waiting for answers. - If the RFI is not `ACTION_REQUIRED`, `provider_kyc.rfi.not_actionable` is returned. If the question is not an IDV question of this RFI, `provider_kyc.rfi.question_not_idv` is returned. - `url` is a one-time session link. Give it only to the person who completes the verification. Do not log or forward it. - After the verification, still submit this question with the full RFI.