# FSN Request and Response
source: https://developer.mastercard.com/fld-suspected-fraud/documentation/parameters/fsn-req_resp/index.md

## FSN Request {#fsn-request}

| **Attribute name** | **Min length** | **Max length** | **Data type** | **Presence** | **Default value** |                                                                                                                             **Field description**                                                                                                                             |             **Example**              |
|--------------------|----------------|----------------|---------------|--------------|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| refId              | 36             | 36             | ANS           | Mandatory    |                   | Unique identification generated by the transaction originator using UUID logic to unambiguously link a request and response message. The only special character allowed will be '-'.                                                                                          | ecb2d942-eabd-42b6-87fd-69c19692bdc6 |
| timestamp          | 29             | 29             | DATE          | Mandatory    |                   | Timestamp of the request initiation by the originator in the format 'YYYY-MM-DDThh:mm:ss                                                                                                                                                                                      | 2021-02-01T20:34:37-06:00            |
| icaNumber          | 3              | 7              | N             | Mandatory    |                   | ICA number of the originator initiating the FDD request.                                                                                                                                                                                                                      | 1076                                 |
| providerId         | 2              | 2              | ENUM          | Mandatory    |                   | Indicates the originator of the request. Possible values are: * 10 for Issuer * 20 for Acquirer For the following scenarios, this value will be '10': * Issuer and Acquirer for a transaction is the same entity * FDD or FDE operation is performed on a Issuer-built record | 10                                   |
| auditControlNumber | 15             | 15             | N             | Mandatory    |                   | 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 to subsequently modify, delete or convert a suspended to a confirmed fraud record.                        | 418142102142002                      |
| operationType      | 1              | 50             | ENUM          | Mandatory    |                   | Indicates the type of operation to be performed for the given audit control number. Possible value is `CONFIRM_FRAUD, NOT_FRAUD`                                                                                                                                              | `CONFIRM_FRAUD`                      |
| notFraudTypeCode   |                | 2              | AN            | Mandatory    |                   | Code to further identify the reason why the originator submitted the transaction as not fraud in FLD. Refer to 'Table 4' in 'Annexure 1' table for possible values.                                                                                                           | "00"                                 |
| memo               | 1              | 1000           | ANS           | Optional     |                   | Brief description by the originator providing some comment supporting the action.                                                                                                                                                                                             |                                      |

## FSN Response {#fsn-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                                                                                                                                                |
| 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.                                     | 000                                                                                                                                                                      |
| responseMessage                   | 1              | 100            | ANS           | Mandatory    | Transaction response description corresponding to the response code.                                                                                                                                                     | Success                                                                                                                                                                  |
| 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                                                                                                                                                                     |
| previousStatus                    | 1              | 50             | ENUM          | Conditional  | Indicates the previous status of the fraud record being submitted. Possible values are: * `SUSPECTED-SUCCESS` This attribute will be absent if the request is not processed by FLD application.                          | SUSPECTED - SUSPECTED                                                                                                                                                    |
| currentStatus                     | 1              | 50             | ENUM          | Conditional  | Indicates the current status of the fraud record being submitted. Possible values are: * `SUSPECTED-NOTCONFIRMED-SUCCESS` This attribute will be absent if the request is not processed by FLD application.              | SUSPECTED - CONFIRMED                                                                                                                                                    |
| 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.                                                                                                                                                                      |                                                                                                                                                                          |