> This page is for Enterprise. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://citi-demo.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://citi-demo.ferndocs.com/_mcp/server. # Initiate Response to Request for Information POST https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations Content-Type: application/json This endpoint allows you to send Response to Request for Information Reference: https://citi-demo.ferndocs.com/enterprises/api-reference/additional-services/ccapi-payments-json/response-to-request-for-information-api/response-to-request-for-information ## Authentication - `Authorization` header (bearer token, required) — All CitiConnect APIs use the oAuth2 authentication scheme, which requires a bearer token to authenticate your API call. The Token URL includes the version of authentication used by this API. See the Citi Authentication API reference for information on requesting a token. ## Servers - `https://b2b.api.icg.citi.com/citiconnect/prod` (production gateway url, default) - `https://sandbox.b2b.api.icg.citi.com/citiconnect/sb` (sbox url ) ## Request ### Query parameters - `client_id` (string, required) — Your unique identification, same as the identification you use for OAuth token generation, Citi shared with you during your CitiConnect API onboarding ### Headers - `Idempotency-Id` (string, required) — Your unique identification for a POST request - Maximum length is 128. - CitiConnect API responds with an error (HTTP status 4XX) if your POST request idempotency identification value is a duplicate across a recent history of idempotency identifications in Citi's database. - If you don't receive any response (HTTP status 2XX, 4XX or 5XX) from Citi to your POST request and you wish to retry, reinitiate your request with the same idempotency identification to prevent accidental duplicate payment. ### Body (application/json) This endpoint expects a Response-To-Request-For-Information. - `rfi_id` (string, required) — RFI ID. - `fieldlevel_requests` (list of Field-Level-Requests-With-Answers, optional) — Field level requests for which response is requested ## Response ### 200 OK - `rfi_id` (string, required) — RFI ID - `status` (InitialResponseToRequestForInformationStatus, required) ## Errors ### 400 Bad Request Error Bad Request - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ### 401 Unauthorized Error Unauthorized - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ### 404 Not Found Error Not Found - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ### 405 Method Not Allowed Error Method Not Allowed - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ### 409 Conflict Error Conflict - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ### 415 Unsupported Media Type Error Unsupported Media Type - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ### 500 Internal Server Error Internal Server Error - `ref_id` (string, optional) — Unique ID for the Transaction - `error_details` (list of Error-Detail, optional) ## Types ### Field-Level-Requests-With-Answers Request can have one or more match level requests. - `field_id` (double, required) — Unique ID for each match. - `field_name` (string, required) — Name of the field where match has occurred. - `field_value` (string, required) — Entire content of the field having the match. - `input_type` (string, required) — The Input type or template to provide the response against the field. It will be one the following - individual / entity / aircraft / vessel / unknown / others. If requested input type is unknown, populate fields from any of the other 4 input types in the response. - `clarification_required_for` (string, optional) — Exact match. - `field_details` (list of Field-Details-with-answers, optional) — Field details with questions requested from client. ### InitialResponseToRequestForInformationStatus - `date_time` (datetime, required) — UTC (ISO 8601 YYYY-MM-DDTHH:MM:SS.sssZ) - Status change date time - `code` (enum, required) — ISO 20022 acknowledgement status code - Allowed values: `PDNG` - `description` (string, required) — Status code description - PDNG - Pending ### Error-Detail - `issue` (string, optional) — more details about the issue - `action` (string, optional) — corrective action to be taken to resolve above issue - `code` (string, optional) — unique code representing the issue ### Field-Details-with-answers Field details can have one or more questions requested from client. - `question_name` (string, required) — Data requested from client. - `answer` (string, required) — Client answer to the question. ## Examples **Request** ```json { "rfi_id": "string" } ``` **Response** ```json { "rfi_id": "string", "status": { "date_time": "2024-01-15T09:30:00Z", "code": "PDNG", "description": "string" } } ``` **SDK Code** ```python import requests url = "https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations" querystring = {"client_id":"6d3cf821-db6d-496d-bec0-064a362e9c31"} payload = { "rfi_id": "string" } headers = { "Idempotency-Id": "a44cbb606de4edb9a7a123414bba3bb", "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31'; const options = { method: 'POST', headers: { 'Idempotency-Id': 'a44cbb606de4edb9a7a123414bba3bb', Authorization: 'Bearer ', 'Content-Type': 'application/json' }, body: '{"rfi_id":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31" payload := strings.NewReader("{\n \"rfi_id\": \"string\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Idempotency-Id", "a44cbb606de4edb9a7a123414bba3bb") req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Idempotency-Id"] = 'a44cbb606de4edb9a7a123414bba3bb' request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"rfi_id\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31") .header("Idempotency-Id", "a44cbb606de4edb9a7a123414bba3bb") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"rfi_id\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31', [ 'body' => '{ "rfi_id": "string" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', 'Idempotency-Id' => 'a44cbb606de4edb9a7a123414bba3bb', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31"); var request = new RestRequest(Method.POST); request.AddHeader("Idempotency-Id", "a44cbb606de4edb9a7a123414bba3bb"); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"rfi_id\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Idempotency-Id": "a44cbb606de4edb9a7a123414bba3bb", "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["rfi_id": "string"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://b2b.api.icg.citi.com/citiconnect/prod/addonservices/v1/responsetorequestforinformations?client_id=6d3cf821-db6d-496d-bec0-064a362e9c31")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```