KRA Microservice
Get Push Onboarding Response

Introduction
This step is required to get the details of the onboarding customer once the data is pushed for further validation.
API Endpoint
Preproduction: 
﻿https://backops-investor-onboarding-preproduction.signzy.tech/kra-handler/api/customers/{{customerId}}/onboardings/{{onboardingId}}﻿
Production:
﻿https://backops-investor-onboarding.signzy.tech/kra-handler/api/customers/{{customerId}}/onboardings/{{onboardingId}}﻿
Sample Request
Preproduction
Curl
  curl --location 'https://backops-investor-onboarding-preproduction.signzy.tech/kra-handler/api/customers/63cf75672bf6b08ae7a28f61/onboardings/null' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: <authorization token>' \
--data ''
  curl --location 'https://backops-investor-onboarding-preproduction.signzy.tech/kra-handler/api/customers/63cf75672bf6b08ae7a28f61/onboardings/null' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: <authorization token>' \
--data ''
﻿
Request Field Description
Key
Data Type
Required/Optional
Description
Header
﻿
﻿
﻿
Content-Type
String
Required
application/json
Authorization
String
Required
Access token from login
Sample Responses
The “response.cvl” is the comprehensive output for all responses associated with a specific onboarding ID.
The field “response.cvlResponseHistory” is an array that stores all responses from previous repushes and auto retries, maintaining them in standard response formats.
Tracking of CVL form submission success is enabled to facilitate the transfer of KYC documents to SFTP upon successful form submission.
200: OK
401
403
404
502
{
   "customerId": "64xxxxxea",
   "id": "65xxxxxx90",
   "response": {
       "cvl": {
           "merchantId": "65xxxxxx90",
           "uuid": "bxxx8-fxxe-4xxf-8xx5-fxxxxx9",
           "kraType": "cvl",
           "rawResponse": {
               "statusCode": "200",
               "respBody": {
                   "msg": {
                       "msg": "SFTP Done",
                       "applicationStatus": "200"
                   }
               }
           },
           "pushResponse": {
               "description": "CVL SFTP process is completed",
               "statusCode": "200",
               "status": "completed"
           },
           "result": "success",
           "status": "completed",
           "lastUpdated": 1709716509947,
           "responseTimeStamp": 1709716509947
       },
       "cvlResponseHistory": [
           {
               "uuid": "bxxx8-fxxe-4xxf-8xx5-fxxxx9",
               "pushTriggeredBy": "64xxxxxea",
               "status": "completed",
               "lastUpdated": 1709716509974,
               "timestamp": 1709716505754,
               "kraType": "cvlResponseHistory",
               "merchantId": "65xxxxxx90",
               "pekrn": "",
               "pushResponse": {
                   "description": "CVL SFTP process is completed",
                   "statusCode": "200",
                   "status": "completed"
               },
               "rawResponse": {
                   "statusCode": "200",
                   "respBody": {
                       "msg": {
                           "msg": "SFTP Done",
                           "applicationStatus": "200"
                       }
                   }
               },
               "responseTimeStamp": 1709716509947,
               "result": "success"
           }
       ],
       "cvlFormUpdates": {
           "formResponse": {
               "response": {
                   "ROOT": {
                       "xmlns": "",
                       "KYCDATA": {
                           "APP_PAN_NO": "WxxxxL",
                           "APP_PAN_DOB": {},
                           "APP_NAME": "SIGNZY_TESTING_GP",
                           "APP_STATUS": "01",
                           "APP_MODF_ACK": "5xx9",
                           "APP_STATUSDT": {},
                           "APP_ENTRYDT": {},
                           "APP_MODDT": {},
                           "APP_POS_CODE": "AxxC"
                       },
                       "FOOTER": {
                           "APP_RESPONSE_DATE": "06/03/2024 14:45:08",
                           "APP_TOTAL_REC": "1"
                       }
                   },
                   "description": "SUBMITTED"
               },
               "submitted": true,
               "formSubmissionTimestamp": 1709716508666
           }
       }
   }
}
{
   "customerId": "64xxxxxea",
   "id": "65xxxxxx90",
   "response": {
       "cvl": {
           "merchantId": "65xxxxxx90",
           "uuid": "bxxx8-fxxe-4xxf-8xx5-fxxxxx9",
           "kraType": "cvl",
           "rawResponse": {
               "statusCode": "200",
               "respBody": {
                   "msg": {
                       "msg": "SFTP Done",
                       "applicationStatus": "200"
                   }
               }
           },
           "pushResponse": {
               "description": "CVL SFTP process is completed",
               "statusCode": "200",
               "status": "completed"
           },
           "result": "success",
           "status": "completed",
           "lastUpdated": 1709716509947,
           "responseTimeStamp": 1709716509947
       },
       "cvlResponseHistory": [
           {
               "uuid": "bxxx8-fxxe-4xxf-8xx5-fxxxx9",
               "pushTriggeredBy": "64xxxxxea",
               "status": "completed",
               "lastUpdated": 1709716509974,
               "timestamp": 1709716505754,
               "kraType": "cvlResponseHistory",
               "merchantId": "65xxxxxx90",
               "pekrn": "",
               "pushResponse": {
                   "description": "CVL SFTP process is completed",
                   "statusCode": "200",
                   "status": "completed"
               },
               "rawResponse": {
                   "statusCode": "200",
                   "respBody": {
                       "msg": {
                           "msg": "SFTP Done",
                           "applicationStatus": "200"
                       }
                   }
               },
               "responseTimeStamp": 1709716509947,
               "result": "success"
           }
       ],
       "cvlFormUpdates": {
           "formResponse": {
               "response": {
                   "ROOT": {
                       "xmlns": "",
                       "KYCDATA": {
                           "APP_PAN_NO": "WxxxxL",
                           "APP_PAN_DOB": {},
                           "APP_NAME": "SIGNZY_TESTING_GP",
                           "APP_STATUS": "01",
                           "APP_MODF_ACK": "5xx9",
                           "APP_STATUSDT": {},
                           "APP_ENTRYDT": {},
                           "APP_MODDT": {},
                           "APP_POS_CODE": "AxxC"
                       },
                       "FOOTER": {
                           "APP_RESPONSE_DATE": "06/03/2024 14:45:08",
                           "APP_TOTAL_REC": "1"
                       }
                   },
                   "description": "SUBMITTED"
               },
               "submitted": true,
               "formSubmissionTimestamp": 1709716508666
           }
       }
   }
}
﻿
Response Field Description
Key
Data type
Description
CustomerId
string
Client's userId obtained from Customer Login API response
Id
string
requestId/merchantId for every application being pushed to KRA
request
Object
Complete Json Data being pushed to KRA
response
Object
Object which contains Response received from KRA(s) as per priority (if multi KRA is used)
CVL/CAMS/KARVY
Object
name of the KRA the application is being pushed on
merchantId
string
requestId of every application being pushed to KRA
kraType
string
name of the KRA the application being pushed on
rawResponse(existing structure)
Object
raw response received from KRA during push which includes various fields from KRA like pan, name dob, status etc.
pushResponse(new structure)
Object
standardised response structure from KRA
description
string
status description received from KRA
statusCode
string
status code of KRA push API
status
string
completed or failure status of KRA push API
result
string
success or failed action of KRA push API
lastUpdated
string
latest timestamp of the KRA push API
responseTimeStamp
string
timestamp at which the response was available
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].
﻿
Reference Tables
Modify Without Document
Docs powered by Archbee
TABLE OF CONTENTS
Introduction
API Endpoint
Sample Request
Request Field Description
Sample Responses
Response Field Description
Getting help
Key	Data Type	Required/Optional	Description
Header
Content-Type	String	Required	application/json
Authorization	String	Required	Access token from login