Fixed Deposit Booking

Create Application

Introduction:
﻿
Sample cURL:
preproduction
production
curl --location 'https://api-preproduction.signzy.app/api/v3/fd-booking/create-application' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth token>' \
--data-raw '{
    "schemeId": "f563ae18-d3bb-5bf2-5b7f-fa0a3483ed4c",
    "tenure": 12,
    "amount": 10000,
    "payableTo": "first_holder",
    "applicants": [
        {
            "salutation": "mr",
            "firstName": "Ravi",
            "middleName": "Kumar",
            "lastName": "Sharma",
            "dateOfBirth": "1990-05-15",
            "gender": "male",
            "email": "[email protected]",
            "mobile": "9876543210",
            "pan": "BODPM4264E",
            "aadhaar": "123412341234",
            "maritalStatus": "married",
            "spouse": {
                "salutation": "mrs",
                "firstName": "Priya",
                "middleName": "Kumari",
                "lastName": "Sharma"
            },
            "father": {
                "salutation": "mr",
                "firstName": "Rajesh",
                "middleName": "Kumar",
                "lastName": "Sharma"
            },
            "annualIncome": "upto_5_lakh",
            "occupation": "business",
            "birthPlace": "Delhi",
            "birthCountry": "India",
            "nationality": "indian",
            "residentialAddress": {
                "addressLine1": "123 MG Road",
                "addressLine2": "Near Central Park",
                "addressLine3": "Sector 5",
                "city": "New Delhi",
                "state": "Delhi",
                "pincode": "110001",
                "country": "India"
            },
            "permanentAddressSameAsResidential": true,
            "permanentAddress": {
                "addressLine1": "123 MG Road",
                "addressLine2": "Near Central Park",
                "addressLine3": "Sector 5",
                "city": "New Delhi",
                "state": "Delhi",
                "pincode": "110001",
                "country": "India"
            }
        }
    ],
    "bank": {
        "accountType": "savings",
        "ifsc": "SBIN0000001",
        "accountNumber": "1234567890"
    },
    "nominees": [
        {
            "salutation": "mr",
            "firstName": "Karan",
            "middleName": "Kumar",
            "lastName": "Sharma",
            "relation": "brother",
            "dateOfBirth": "2004-08-03",
            "guardian": {
                "salutation": "mr",
                "firstName": "Amit",
                "middleName": "Kumar",
                "lastName": "Sharma"
            }
        }
    ],
    "ipAddress": "192.168.1.1"
}
'
curl --location 'https://api-preproduction.signzy.app/api/v3/fd-booking/create-application' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth token>' \
--data-raw '{
    "schemeId": "f563ae18-d3bb-5bf2-5b7f-fa0a3483ed4c",
    "tenure": 12,
    "amount": 10000,
    "payableTo": "first_holder",
    "applicants": [
        {
            "salutation": "mr",
            "firstName": "Ravi",
            "middleName": "Kumar",
            "lastName": "Sharma",
            "dateOfBirth": "1990-05-15",
            "gender": "male",
            "email": "ravi.sharma@example.com",
            "mobile": "9876543210",
            "pan": "BODPM4264E",
            "aadhaar": "123412341234",
            "maritalStatus": "married",
            "spouse": {
                "salutation": "mrs",
                "firstName": "Priya",
                "middleName": "Kumari",
                "lastName": "Sharma"
            },
            "father": {
                "salutation": "mr",
                "firstName": "Rajesh",
                "middleName": "Kumar",
                "lastName": "Sharma"
            },
            "annualIncome": "upto_5_lakh",
            "occupation": "business",
            "birthPlace": "Delhi",
            "birthCountry": "India",
            "nationality": "indian",
            "residentialAddress": {
                "addressLine1": "123 MG Road",
                "addressLine2": "Near Central Park",
                "addressLine3": "Sector 5",
                "city": "New Delhi",
                "state": "Delhi",
                "pincode": "110001",
                "country": "India"
            },
            "permanentAddressSameAsResidential": true,
            "permanentAddress": {
                "addressLine1": "123 MG Road",
                "addressLine2": "Near Central Park",
                "addressLine3": "Sector 5",
                "city": "New Delhi",
                "state": "Delhi",
                "pincode": "110001",
                "country": "India"
            }
        }
    ],
    "bank": {
        "accountType": "savings",
        "ifsc": "SBIN0000001",
        "accountNumber": "1234567890"
    },
    "nominees": [
        {
            "salutation": "mr",
            "firstName": "Karan",
            "middleName": "Kumar",
            "lastName": "Sharma",
            "relation": "brother",
            "dateOfBirth": "2004-08-03",
            "guardian": {
                "salutation": "mr",
                "firstName": "Amit",
                "middleName": "Kumar",
                "lastName": "Sharma"
            }
        }
    ],
    "ipAddress": "192.168.1.1"
}
'
﻿
Input Parameters:
Parameter
Type
Description
Mandatory/Optional
schemeId
String
Identifier for the associated scheme.
Mandatory
tenure
Number
Tenure of the application.
Mandatory
amount
Number
Amount applied.
Mandatory
payableTo
String
Payable to.                                                           Value: ["first_holder"]
Mandatory
applicants
Array of Objects
Applicant information.  (1 items)
Mandatory
applicants.salutation
String
Salutation of the applicant.                                 Value: ["mr", "mrs", "ms"]
Mandatory
applicants.firstName
String
First name of the applicant.
Mandatory
applicants.middleName
String
Middle name of the applicant.
Optional
applicants.lastName
String
Last name of the applicant.
Mandatory
applicants.dateOfBirth
String
Date of birth of the applicant (ISO 8601 date format). For example, "2017-07-21"
Mandatory
applicants.gender
String
Gender of the applicant.                                                  Value: ["male", "female", "transgender"]
Mandatory
applicants.email
String
Email address of the applicant.
Mandatory
applicants.mobile
String
Mobile number of the applicant.
Mandatory
applicants.pan
String
PAN number of the applicant (10 characters).
Mandatory
applicants.aadhaar
String
Aadhaar number of the applicant (12 characters).
Mandatory
applicants.ckycNumber
String
ckyc number of the applicant.
Optional
applicants.maritalStatus
String
Marital status of the applicant.                                          Value: ["married", "unmarried", "other"]
Mandatory
applicants.annualIncome
String
Annual income range of the applicant.                              Value: ["upto_5_lakh", "above_5_lakh_upto_10_lakh", "above_10_lakh_upto_15_lakh", "above_15_lakh_upto_25_lakh", "above_25_lakh_upto_50_lakh", "above_50_lakh_upto_1_crore", "above_1_crore"]
Mandatory
applicants.occupation
String
Occupation of the applicant.                               Value: ["business", "agriculture", "forex_dealer", "service_public_sector", "service_private_sector", "service_government_sector", "others_professional", "others_self_employed", "others_retired", "others_housewife", "others_student", "others"]
Mandatory
applicants.birthPlace
String
Place of birth of the applicant.
Mandatory
applicants.birthCountry
String
Country of birth of the applicant.
Mandatory
applicants.nationality
String
Nationality of the applicant.                                 Value: ["indian"]
Mandatory
applicants.spouse
Object
Details of the spouse, if applicable.
Optional, If provided then all details inside it is mandatory except Middle name
applicants.spouse.salutation
String
Salutation of the spouse.                                     Value: ["mr", "mrs", "ms"]
Mandatory
applicants.spouse.firstName
String
First name of the spouse.
Mandatory
applicants.spouse.middleName
String
Middle name of the spouse.
Optional
applicants.spouse.lastName
String
Last name of the spouse.
Mandatory
applicants.father
Object
Details of the father, if applicable.
Optional, If provided then all details inside it is mandatory except Middle name
applicants.father.salutation
String
Salutation of the father.                                       Value: ["mr", "mrs", "ms"]
Mandatory
applicants.father.firstName
String
First name of the father.
Mandatory
applicants.father.middleName
String
Middle name of the father.
Optional
applicants.father.lastName
String
Last name of the father.
Mandatory
applicants.residentialAddress
Object
Residential address of the applicant.
Mandatory
applicants.residentialAddress.addressLine1
String
Address line 1.
Mandatory
applicants.residentialAddress.addressLine2
String
Address line 2.
Optional
applicants.residentialAddress.addressLine3
String
Address line 3.
Optional
applicants.residentialAddress.city
String
City 
Mandatory
applicants.residentialAddress.state
String
State
Mandatory
applicants.residentialAddress.pincode
String
Pincode 
Mandatory
applicants.residentialAddress.country
String
Country
Mandatory
applicants.permanentAddressSameAsResidential
Boolean
Indicates if the permanent address is the same as residential address. 
Mandatory
applicants.permanentAddress
Object
Permanent address of the applicant, if different from residential address.                 Value: [true, false]
true: permanentAddress is optional but if provided then it's mandatory
false: permanentAddress is mandatory
Conditionally Mandatory
applicants.permanentAddress.addressLine1
String
Address line 1.
Mandatory
applicants.permanentAddress.addressLine2
String
Address line 2.
Optional
applicants.permanentAddress.addressLine3
String
Address line 3.
Optional
applicants.permanentAddress.city
String
City
Mandatory
applicants.permanentAddress.state
String
State
Mandatory
applicants.permanentAddress.pincode
String
Pincode
Mandatory
applicants.permanentAddress.country
String
Country
Mandatory
bank
Object
Bank details of applicant.
Mandatory
bank.accountType
String
Type of bank account.                                         Value: ["savings", "current"]
Mandatory
bank.ifsc
String
IFSC code of the bank branch.
Mandatory
bank.accountNumber
String
Account number.
Mandatory
nominees
Array of Objects
Detail of nominees.
Optional, If provided then all details inside it is mandatory
nominees.salutation
String
Salutation of the nominee.                                       Value: ["mr", "mrs", "ms"]
Mandatory
nominees.firstName
String
First name of the nominee.
Mandatory
nominees.middleName
String
Middle name of the nominee.
Optional
nominees.lastName
String
Last name of the nominee.
Mandatory
nominees.dateOfBirth
String
Date of birth of the nominee (ISO 8601 date format).  For example, "2017-07-21"
Mandatory
nominees.relation
String
Relation to the applicant.                                       Value: ["brother", "sister", "father", "mother", "son", "daughter", "husband", "wife", "other"]
Mandatory
nominees.guardian
Object
Guardian details of nominee. Its required if nominee is minor.
Conditionally Optional, If provided then all details inside it is mandatory except middle name
nominees.guardian.salutation
String
Salutation of the guardian.                                       Value: ["mr", "mrs", "ms"]
Mandatory
nominees.guardian.firstName
String
First name of the guardian.
Mandatory
nominees.guardian.middleName
String
Middle name of the guardian.
Optional
nominees.guardian.lastName
String
Last name of the guardian.
Mandatory
ipAddress
String
IP address of the user.
Mandatory
Output Parameters: 
Key
Type
Description
id 
String
The unique identifier of the application
status
String
Status of the application.                                                                         Value: ["new""awaiting_payment", "awaiting_documents", "under_review", "active", "matured", "rejected"]
Status Codes:
200
400
401
404
409
500
{
    "message": "Invalid authentication credentials"
}
{
    "message": "Invalid authentication credentials"
}
﻿
﻿

Scheme Details

Application Details

Docs powered by Archbee

TABLE OF CONTENTS

Parameter	Type	Description	Mandatory/Optional
schemeId	String	Identifier for the associated scheme.	Mandatory
tenure	Number	Tenure of the application.	Mandatory
amount	Number	Amount applied.	Mandatory
payableTo	String	Payable to. Value: ["first_holder"]	Mandatory
applicants	Array of Objects	Applicant information. (1 items)	Mandatory
applicants.salutation	String	Salutation of the applicant. Value: ["mr", "mrs", "ms"]	Mandatory
applicants.firstName	String	First name of the applicant.	Mandatory
applicants.middleName	String	Middle name of the applicant.	Optional
applicants.lastName	String	Last name of the applicant.	Mandatory
applicants.dateOfBirth	String	Date of birth of the applicant (ISO 8601 date format). For example, "2017-07-21"	Mandatory
applicants.gender	String	Gender of the applicant. Value: ["male", "female", "transgender"]	Mandatory
applicants.email	String	Email address of the applicant.	Mandatory
applicants.mobile	String	Mobile number of the applicant.	Mandatory
applicants.pan	String	PAN number of the applicant (10 characters).	Mandatory
applicants.aadhaar	String	Aadhaar number of the applicant (12 characters).	Mandatory
applicants.ckycNumber	String	ckyc number of the applicant.	Optional
applicants.maritalStatus	String	Marital status of the applicant. Value: ["married", "unmarried", "other"]	Mandatory
applicants.annualIncome	String	Annual income range of the applicant. Value: ["upto_5_lakh", "above_5_lakh_upto_10_lakh", "above_10_lakh_upto_15_lakh", "above_15_lakh_upto_25_lakh", "above_25_lakh_upto_50_lakh", "above_50_lakh_upto_1_crore", "above_1_crore"]	Mandatory
applicants.occupation	String	Occupation of the applicant. Value: ["business", "agriculture", "forex_dealer", "service_public_sector", "service_private_sector", "service_government_sector", "others_professional", "others_self_employed", "others_retired", "others_housewife", "others_student", "others"]	Mandatory
applicants.birthPlace	String	Place of birth of the applicant.	Mandatory
applicants.birthCountry	String	Country of birth of the applicant.	Mandatory
applicants.nationality	String	Nationality of the applicant. Value: ["indian"]	Mandatory
applicants.spouse	Object	Details of the spouse, if applicable.	Optional, If provided then all details inside it is mandatory except Middle name
applicants.spouse.salutation	String	Salutation of the spouse. Value: ["mr", "mrs", "ms"]	Mandatory
applicants.spouse.firstName	String	First name of the spouse.	Mandatory
applicants.spouse.middleName	String	Middle name of the spouse.	Optional
applicants.spouse.lastName	String	Last name of the spouse.	Mandatory
applicants.father	Object	Details of the father, if applicable.	Optional, If provided then all details inside it is mandatory except Middle name
applicants.father.salutation	String	Salutation of the father. Value: ["mr", "mrs", "ms"]	Mandatory
applicants.father.firstName	String	First name of the father.	Mandatory
applicants.father.middleName	String	Middle name of the father.	Optional
applicants.father.lastName	String	Last name of the father.	Mandatory
applicants.residentialAddress	Object	Residential address of the applicant.	Mandatory
applicants.residentialAddress.addressLine1	String	Address line 1.	Mandatory
applicants.residentialAddress.addressLine2	String	Address line 2.	Optional
applicants.residentialAddress.addressLine3	String	Address line 3.	Optional
applicants.residentialAddress.city	String	City	Mandatory
applicants.residentialAddress.state	String	State	Mandatory
applicants.residentialAddress.pincode	String	Pincode	Mandatory
applicants.residentialAddress.country	String	Country	Mandatory
applicants.permanentAddressSameAsResidential	Boolean	Indicates if the permanent address is the same as residential address.	Mandatory
applicants.permanentAddress	Object	Permanent address of the applicant, if different from residential address. Value: [true, false] true: permanentAddress is optional but if provided then it's mandatory false: permanentAddress is mandatory	Conditionally Mandatory
applicants.permanentAddress.addressLine1	String	Address line 1.	Mandatory
applicants.permanentAddress.addressLine2	String	Address line 2.	Optional
applicants.permanentAddress.addressLine3	String	Address line 3.	Optional
applicants.permanentAddress.city	String	City	Mandatory
applicants.permanentAddress.state	String	State	Mandatory
applicants.permanentAddress.pincode	String	Pincode	Mandatory
applicants.permanentAddress.country	String	Country	Mandatory
bank	Object	Bank details of applicant.	Mandatory
bank.accountType	String	Type of bank account. Value: ["savings", "current"]	Mandatory
bank.ifsc	String	IFSC code of the bank branch.	Mandatory
bank.accountNumber	String	Account number.	Mandatory
nominees	Array of Objects	Detail of nominees.	Optional, If provided then all details inside it is mandatory
nominees.salutation	String	Salutation of the nominee. Value: ["mr", "mrs", "ms"]	Mandatory
nominees.firstName	String	First name of the nominee.	Mandatory
nominees.middleName	String	Middle name of the nominee.	Optional
nominees.lastName	String	Last name of the nominee.	Mandatory
nominees.dateOfBirth	String	Date of birth of the nominee (ISO 8601 date format). For example, "2017-07-21"	Mandatory
nominees.relation	String	Relation to the applicant. Value: ["brother", "sister", "father", "mother", "son", "daughter", "husband", "wife", "other"]	Mandatory
nominees.guardian	Object	Guardian details of nominee. Its required if nominee is minor.	Conditionally Optional, If provided then all details inside it is mandatory except middle name
nominees.guardian.salutation	String	Salutation of the guardian. Value: ["mr", "mrs", "ms"]	Mandatory
nominees.guardian.firstName	String	First name of the guardian.	Mandatory
nominees.guardian.middleName	String	Middle name of the guardian.	Optional
nominees.guardian.lastName	String	Last name of the guardian.	Mandatory
ipAddress	String	IP address of the user.	Mandatory

Key	Type	Description
id	String	The unique identifier of the application
status	String	Status of the application. Value: ["new""awaiting_payment", "awaiting_documents", "under_review", "active", "matured", "rejected"]