Skip to content

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":{
  }
}