Skip to main content

Funds Withdrawal

This API allows you to withdraw funds from a trading account to a linked bank account. You must specify the account details, withdrawal type (automatic or manual), and product-related information.

🔑Header Parameters

ParameterTypeDescriptionExample/ENUM
AuthorizationstringBearer token for authenticating the request.Bearer {{access_token}}
Content-TypestringSpecifies the media type of the request body.application/json
x-api-keystringAPI key provided to access the service.{{x-api-key}}

📦Request Body Schema

ParameterTypeDescriptionExample/ENUM
accNostringAccount number from which funds are to be withdrawn."1234567890"
amountstringAmount of funds to withdraw."2500"
appWithdrawKeystringDetermines the mode of withdrawal."1" = auto withdrawal, "2" = manual withdrawal
bankIdstringUnique identifier of the bank linked for withdrawal."HDFC152"
productIdstringProduct ID linked to the funds (refer to Balance → Product-wise balance)."100"
productNamestringProduct name linked to the funds."Trading"

🟢Success Response - 200 Ok

FieldTypeDescriptionExample/ENUM
statusstringIndicates the status of the API call."success"
codestringResponse code indicating result."s-101"
messagestringMessage indicating successful withdrawal."Success message"
dataobjectOptional object containing additional response data.Details below

📘Data Object Field

FieldTypeDescriptionExample/ENUM
ResponseStringstringAdditional message or technical status returned by the system."Request for Withdraw Funds has been successfully sent. Transaction Reference No: 22040113700000016"
post/transactional/v1/fundsWithdrawal