Get Corporate Customer API
Get Corporate Customer API
- Ajaimoan Antony
Owned by Ajaimoan Antony
Mar 26, 2025
Version History:
Version | Description | Author | Date (dd/mm/yyyy) |
1.0.0 | Get Corporate Customer API Document | Ajai Antony | 26/03/2025 |
CLASSIFICATION: PUBLIC
API to be used to get the corporate information by customer number.
API | |
Authorization | Bearer Token |
Method | GET |
Headers | Content-Type:application/json |
Payload | None |
Success Response
HttpStatusCode: 200 | {
"requestId": "65d6c6a1202ec6dc8b894eaf5128795c",
"status": "success",
"statusCode": 200,
"data": {
"ecrn": "7841003249386495",
"cad_number": "AE563147841003249386495",
"legal_name": "GRACE",
"country": "AE",
"state": "Kerala",
"district": "Trivandrum",
"city": "qwerty",
"office_bldg_number": "ASDFGH",
"building_name": "GTC",
"company_address": "chennai",
"street_name": "Red Cross Lane",
"po_box": "123456",
"zip_code": 123456,
"post_code": 123456,
"land_mark": "Trivandrum",
"primary_mobile_number": "1234567890",
"phone_number": "9874563210",
"company_code": "LINUX",
"email": "LINUX@lulu.com",
"web_site": "www.linux.com",
"number_of_employees": 1000,
"inception_date": "2020-05-30",
"industry_type": "IT",
"type_of_business": "1",
"credit_limit": 1000,
"credit_period": 90,
"last_review_date": null,
"next_review_date": null,
"pan": "DRFT5421D",
"business_functions": "IT func",
"trn": "21500",
"trn_issued_country": "AE",
"preferred_services": "Pr Services",
"is_fatca": true,
"is_pep": null,
"channel": "BRANCH",
"agent_location_id": "784101",
"updated_agent_location_id": null,
"updated_channel": null,
"updated_on": null,
"updated_by": "anjaly",
"referred_by": "sujith",
"referred_by_type": 3,
"risk_category": null,
"profile_status": "ACTIVE",
"nature_of_corporate": 2,
"aml_scan_status": "Accepted",
"aml_category": 1,
"corporate_category": 1,
"corporate_executive_details": [
{
"executive_ecrn": "7022417161195923",
"ecrn": "7028003241019520",
"designation_id": "4",
"status": "ACTIVE",
"aml_scan_status": "Accepted",
"file_name": null,
"date_updated": "2024-12-23T09:55:52.162712Z",
"first_name": "SANDY",
"middle_ame": null,
"last_name": "TRDAPPROVE",
"nationality": "CA",
"customer_type_id": 1,
"corporate_executive_id_details": [
{
"id_type": 2,
"id_number": "M23243455",
"name_as_per_id": null,
"issued_on": null,
"date_of_expiry": null,
"issued_country": " ",
"issued_by": "",
"active_status": "false"
}
]
}
],
"account_details": [
{
"currency": "INR",
"account_type": "Joint",
"bank_name": "SBI",
"account_name": "Linux Ex",
"account_no": "154462623211",
"bank_address": "SBI, chennai",
"country": "AE",
"iban": "SBI6446631",
"swift_code": "154513",
"ifsc_code": "SBI4510",
"date_updated": "2024-11-14T05:05:05.867465Z",
"bank_id": "234567",
"bank_branch_id": null
}
],
"group_company_details": [
{
"parent_company_name": null,
"licence_number": "L1234",
"issued_at_country": "AE",
"issued_date": "2022-04-30",
"company_code": "LuluEx",
"number_of_employees": "100",
"date_updated": "2024-11-14T05:05:05.868768Z"
}
],
"financials": {
"currency": null,
"annual_turn_over": 500000.0,
"projected_sales_volumes": 100000.0,
"net_profit": 5000.0,
"sales_invoice_terms": "Terms",
"company_capital": 200000.0,
"audited_financials": null,
"inhouse_financials": null,
"debtors_report": null,
"creditors_report": null,
"credit_line_facilities": null,
"date_updated": "2024-11-18T09:37:18.476327Z"
},
"share_holders_details": [
{
"share_percentage": "10",
"first_name": "sujith",
"middle_name": "k",
"last_name": "g",
"gender": "M",
"date_of_birth": "1980-06-16T00:00:00.000+00:00",
"residency_address_1": "Add 1",
"residency_address_2": "Add 2",
"residency_address_3": "Add 3",
"country_of_residency": "AE",
"region": "India",
"nationality": "AE",
"email_id": "sujith@lulu.com",
"mobile_number": "9874563210",
"phone_number": "9874563210",
"id_type": "1",
"id_no": "123",
"issued_on": "2022-06-30",
"valid_through": "2022-07-30T00:00:00.000+00:00",
"issued_by": "India",
"country": "AE",
"is_fatca": true,
"is_pep": true,
"date_updated": "2024-11-14T05:05:05.586486Z",
"uploaded_id": null
}
],
"id_details": [
{
"ecrn": "7841003249386495",
"issuedAt": "AE Govt.",
"id_type": 5,
"id_number": "1234567890",
"issued_country": "AE",
"issued_by": "EIDA",
"issued_on": "2020-08-08",
"date_of_expiry": "2027-04-04",
"default_status": true,
"active_status": true,
"id_front_file_name": "corporate/id/7841003249386495_ID_FR_5_1234567890.jpeg",
"id_back_file_name": "corporate/id/7841003249386495_ID_BK_5_1234567890.jpeg",
"disable": false
}
],
"additional_docs": [
{
"document_name": null,
"issued_on": null,
"valid_through": null,
"uploaded_document": null
}
]
}
} |
Customer not found Failure Response HttpStatusCode : 200 | {
"status": "failure",
"statusCode": 404,
"errorCode": 45020,
"message": "Corporate Details Not Found "
} |
Authentication Failure Response | {
"timestamp": "2023-03-15T14:26:24.292+00:00",
"status": 401,
"error": "Unauthorized",
"message": "",
"path": "/api/v1/customer/7841001228796988"
} |
, multiple selections available,