Profile
The profile API is designed to retrieve comprehensive information about a user. Upon making a request to this API, the response typically contains all the details associated with the client, including personal, financial, and account-related information.
Endpoint: /api/v1/user/trading_info
Method-Type: GET
Query Params
{
"client_id": "YG1234"
}
Response
{
"data": {
"last_password_change_date": 1700543471,
"dob": "2000-01-01",
"bank_state": "DELHI",
"bank_branch_name": "NA",
"bank_account_number": "11233435545",
"pan_number": "Pan Number",
"user_type": "CLIENT",
"account_type": "SAVING",
"exchanges_subscribed": [
"BSE",
"MCX",
"NFO",
"NSE"
],
"ifsc_code": "IFSC-code",
"status": "active",
"office_addr": "Address",
"bank_name": "ICICI BANK LTD",
"depository": null,
"client_id": "YG0008",
"name": "Name",
"exchange_nnf": {
"BSE": 0,
"MCX": 0,
"NFO": 0,
"NSE": 0
},
"dp_id": [
"12049845"
],
"profile_url": "",
"backoffice_link": "",
"permanent_addr": "address,",
"city": "NEW DELHI",
"branch": "STAFF",
"cp_code": null,
"sex": "MALE",
"broker_id": null,
"poa_status": false,
"phone_number": "2234345467",
"role": {
"id": 2,
"name": "BASIC_CLIENT"
},
"bo_id": [
"3758458456955"
],
"state": "DELHI",
"products_enabled": [
"NRML",
"MIS",
"CNC"
],
"bank_city": "NEW DELHI",
"poa_enabled": false,
"basket_enabled": false,
"twofa_enabled": false,
"email_id": "Email",
"user_conscents": [],
"entity_type": "RETAIL"
},
"message": "",
"status": "success"
}
Response Parameters
Key | Description |
---|---|
permanent_addr | Permanent address of the client. |
exchange_nnf | Subscription status for various exchanges (BSE, MCX, NFO, NSE) - 0 means not subscribed. |
sex | Gender of the client. |
account_type | Type of account (e.g., savings, current). |
bank_account_number | Bank account number of the client. |
bank_city | City where the bank is located. |
twofa_enabled | Two-factor authentication status - true/false. |
bo_id | Back office identifier(s) associated with the client. |
dp_id | Depository participant identifier(s) associated with the client. |
backoffice_link | Link to the back office system for the client. |
status | Status of the client's account. |
office_addr | Office address of the client. |
ifsc_code | IFSC code of the bank associated with the client. |
depository | Depository associated with the client (null if not specified). |
name | Name of the client. |
client_id | Unique identifier for the client. |
profile_url | URL of the client's profile. |
last_password_change_date | Date when the client last changed their password. |
phone_number | Phone number of the client. |
role | Role of the client (id and name). |
user_type | Type of user (e.g., CLIENT, STAFF). |
exchanges_subscribed | List of exchanges subscribed by the client. |
poa_enabled | Power of attorney (POA) status - true/false. |
cp_code | CP (Clearing Participant) code associated with the client. |
email_id | Email address of the client. |
branch | Branch of the bank where the client's account is held. |
bank_state | State where the bank is located. |
poa_status | Power of attorney (POA) status - true/false. |
dob | Date of birth of the client. |
broker_id | Unique identifier for the broker associated with the client. |
city | City where the client resides. |
state | State where the client resides. |
basket_enabled | Basket order facility status - true/false. |
pan_number | Permanent account number (PAN) of the client. |
bank_branch_name | Name of the bank branch. |
products_enabled | List of products enabled for the client (e.g., NRML, MIS, CNC). |
bank_name | Name of the bank associated with the client. |
user_conscents | User consents (if any). |
entity_type | Type of entity (e.g., RETAIL, CORPORATE). |
Error Response
{
"status": "error",
"message": "Request forbidden",
"error_code": 40000,
"data":{
}
}