# SFS Request and Response
source: https://developer.mastercard.com/fld-suspected-fraud/documentation/parameters/sfs-req/index.md

## SFS Request {#sfs-request}

| **Attribute name** | **Min length** | **Max length** | **Data type** | **Presence** | **Default value** |                                                             **Field description**                                                             |             **Example**              |
|--------------------|----------------|----------------|---------------|--------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| ica Number         | 3              | 7              | N             | Mandatory    |                   | Refers to the ICA of the fraud record which needs to be searched for its status. It is mandatory parameter along with Ref ID or ACN           | 1076                                 |
| ref_Id             | 36             | 36             | ANS           | Conditional  |                   | Refers to the reference IDof the API call which was used to submit fraud record. This is optional parameter if ACN is present in the request. | ecb2d942-eabd-42b6-87fd-69c19692bdc6 |
| acn                | 15             | 15             | N             | Conditional  |                   | Refers to the ACN of the fraud record whose status is to be fetched. This is optional parameter for record submitted through APIs.            | 418142102142002                      |

## SFS Response {#sfs-response}

|        **Attribute name**         | **Min length** | **Max length** | **Data type** | **Presence** |                                                                                                                                                                             **Field description**                                                                                                                                                                              |                                                                               **Example**                                                                                |
|-----------------------------------|----------------|----------------|---------------|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| refId                             | 36             | 36             | ANS           | Mandatory    | Unique identification generated by the transaction originator in the request API which is echoed back to link a request and response message.                                                                                                                                                                                                                                  | ecb2d942-eabd-42b6-87fd-69c19692bdc6                                                                                                                                     |
| timestamp                         | 29             | 29             | DATE          | Mandatory    | Timestamp of the response initiation by Mastercard in the format 'YYYY-MM-DDThh:mm:ss'. The value of '+hh:mm' portion should always be '-06:00' reflecting CST time.                                                                                                                                                                                                           | 2021-02-01T20:34:40-06:00                                                                                                                                                |
| icaNumber                         | 3              | 7              | N             | Conditional  | ICA number of the originator provided in the request API which is echoed back. This attribute will be absent if the request is not processed by FLD application.                                                                                                                                                                                                               | 1076                                                                                                                                                                     |
| responseCode                      | 3              | 3              | N             | Mandatory    | Response code indicating success or failure of the transaction at an API level. Errors at a record level will be handled through 'errorDetails' element associated with each record.                                                                                                                                                                                           | 0                                                                                                                                                                        |
| responseMessage                   | 1              | 100            | ANS           | Mandatory    | Transaction response description corresponding to the response code.                                                                                                                                                                                                                                                                                                           | Success                                                                                                                                                                  |
| auditControlNumber                | 15             | 15             | N             | Conditional  | Unique number generated by FLD application and provided in the response message for a successful fraud record submission ('FDA' event). This is used as a reference in the request API to subsequently modify, delete or convert a suspended to a confirmed fraud record and is echoed back. This attribute will be absent if the request is not processed by FLD application. | 418142102142002                                                                                                                                                          |
| channel                           | 1              | 50             | A             |              | Array list containing the combination of error reason codes and their corresponding description (can provide up to 5 errors for a record). It will be absent if the request is processed by FLD application successfully.                                                                                                                                                      | Online                                                                                                                                                                   |
| submissionStatus                  | 1              | 50             | A             | Conditional  | Indicates the submission status of the suspected transaction.                                                                                                                                                                                                                                                                                                                  | NEW                                                                                                                                                                      |
| currentStatus                     | 1              | 50             | ENUM          | Conditional  | Indicates the current status of the fraud record being submitted. Possible values are: * `CONFIRMED - SUCCESS` * `CONFIRMED - SUCCESS` * `CONFIRMED - REJECTED` * `CONFIRMED - SUSPENDED` This attribute will be absent if the request is not processed by FLD application.                                                                                                    |                                                                                                                                                                          |
| fraudOriginator                   | 4              | 8              | ENUM          | Conditional  | Indicates who has submitted the transaction. If only Issuer submitted the transaction then value of this field will be 'ISSUER'. If only Acquirer submitted the transaction then value of this field will be 'ACQUIRER'. If both the parties have submitted the transaction then the value of this field will be 'BOTH'.                                                       | ISSUER                                                                                                                                                                   |
| errorDetails -\> Errors -\> Error | NA             | NA             | NA            | Conditional  | Array list containing the combination of error reason codes and their corresponding description (can provide up to 5 errors for a record).It will be absent if the request is processed by FLD application successfully.                                                                                                                                                       | * Code ```code "errorDetails":{ "Errors":{ "Error":[ { "ReasonCode":"60002", "Description":"timestamp attribute or attribute value is missing or incorrect." } ] } } ``` |
| ReasonCode                        | 5              | 5              | N             | Conditional  | Error code indicating the reason for the failure of a particular record.                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                          |
| Description                       | 1              | 1000           | ANS           | Conditional  | Description corresponding to the error reason code.                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                          |