UBO Status

Endpoint Overview

GET /api/v1/mca-ubo/status

Description

This API retrieves detailed Ultimate Beneficial Owner (UBO) information for a company, providing a comprehensive view of the ownership structure. It returns entity details, complete shareholder hierarchy, and precise ownership percentages, allowing you to understand the complete ownership chain from the target company to the ultimate beneficial owners.

The API helps organizations meet regulatory compliance requirements for KYC (Know Your Customer) and AML (Anti-Money Laundering) by identifying individuals who ultimately own or control a company, even through multiple layers of ownership.

Key Benefits

Obtain complete ownership hierarchy with accurate shareholding percentages at each level

Identify ultimate beneficial owners with consolidated ownership percentages

Access comprehensive entity and shareholder details including contact information

Track ownership through multiple corporate layers to identify controlling individuals

Use Cases

Financial Services

Corporate Compliance

Legal & Regulatory

Perform enhanced due diligence on corporate clients during onboarding

Verify beneficial ownership for regulatory compliance reporting

Assess risk profiles of potential business partners based on ownership structure

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT format)
Content-Type	Yes	application/json

Query Parameters

Parameter	Type	Required	Description
client_id	String	Yes	Unique identifier of the UBO retrieval process

Example Request

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the UBO information
data.client_id	String	Unique identifier for the API request
data.entity_id	String	Entity's unique identification number
data.entity_type	String	Type of the entity
data.status	String	Status of the UBO retrieval process (completed, pending, failed)
data.error_message	String	Reason for failure (if status is failed)
data.entity_cin	String	CIN of the company (if applicable)
data.company_name	String	Name of the company
data.company_address	String	Full address of the company
data.company_email	String	Email address of the company
data.company_pan	String	PAN number of the company
data.company_type	String	Type of the company (e.g., private, public)
data.ubo_chain	Array	List of shareholder details forming the UBO hierarchy
status_code	Integer	HTTP status code
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code representing the response message

UBO Chain Object Structure

Parameter	Type	Description
shareholder_name	String	Name of the shareholder
shareholding_percentage	Float	Percentage of shares held by the shareholder
shareholder_dob	String	Date of birth of the shareholder (YYYY-MM-DD)
shareholder_cin	String	CIN of the shareholder entity
shareholder_din	String	DIN of the shareholder
shareholder_pan	String	PAN of the shareholder
shareholder_contact	String	Contact number of the shareholder
shareholder_email	String	Email address of the shareholder
shareholder_address	String	Full address of the shareholder
no_of_shares	Integer	Number of shares held by the shareholder
is_director	Boolean	Whether the shareholder is a director
company_type	String	Type of the shareholder company
source	String	Source of the shareholder information
parent	String	CIN/Entity ID of the parent entity in the hierarchy
level	Integer	Level of the shareholder in the ownership hierarchy
shareholder_type	String	Type of the shareholder (individual, company)
ultimate_ownership_percentage	Float	Final ownership percentage in the company by this shareholder

Example Successful Response

{
    "data": {
        "client_id": "mca_ubo_BQgmfkfdFjxqhwRedZqt",
        "entity_id": "L51500MH9876PLC001234",
        "entity_type": "company",
        "status": "completed",
        "entity_cin": "L51500MH9876PLC001234",
        "company_name": "THE INDIAN HUME PIPE COMPANY LIMITED",
        "company_address": "CONSTRUCTION HOUSE WALCHANDHIRACHAND MARG BALLARD ESTATE FORT, MMUMBAI, Maharashtra - 400001",
        "company_email": "info@indianhumepipe.com",
        "company_pan": "AAACT1234D",
        "company_type": "public",
        "ubo_chain": [
            {
                "shareholder_name": "IHP FINVEST LIMITED",
                "shareholding_percentage": 65.92,
                "shareholder_dob": null,
                "shareholder_cin": "U65920MH1996PLC101234",
                "shareholder_din": "",
                "shareholder_pan": "AAACI1234P",
                "shareholder_contact": "",
                "shareholder_email": "ihpfinvest@yahoo.co.in",
                "shareholder_address": "CONSTRUCTION HOUSE, 2ND FLOOR, WALCHAND HIRACHAND MARG, MUMBAI, Maharashtra - 400001",
                "no_of_shares": null,
                "is_director": false,
                "company_type": "private",
                "source": "mca",
                "parent": "L51500MH9876PLC001234",
                "level": 1,
                "shareholder_type": "company",
                "ultimate_ownership_percentage": 65.92
            },
            {
                "shareholder_name": "RATANCHAND INVESTMENT PRIVATE LIMITED",
                "shareholding_percentage": 86.49,
                "shareholder_dob": null,
                "shareholder_cin": "U61110MH1996PTC101234",
                "shareholder_din": "",
                "shareholder_pan": "AABCR1234J",
                "shareholder_contact": "",
                "shareholder_email": "ratanchandinvestment@gmail.com",
                "shareholder_address": "CONSTRUCTION HOUSE2ND FLR WALCHAND HIRACHAND MARG BALLARD EST, MUMBAI, Maharashtra - 400001",
                "no_of_shares": null,
                "is_director": false,
                "company_type": "private",
                "source": "mca",
                "parent": "U65920MH1996PLC101234",
                "level": 2,
                "shareholder_type": "company",
                "ultimate_ownership_percentage": 57.01
            },
            {
                "shareholder_name": "RAJAS RATANCHAND DOSHI",
                "shareholding_percentage": 5.94,
                "shareholder_dob": "1951-01-01",
                "shareholder_cin": "",
                "shareholder_din": "00050594",
                "shareholder_pan": "AAGPD1234L",
                "shareholder_contact": "",
                "shareholder_email": "rajasrdoshi@gmail.com",
                "shareholder_address": "33, LAS PALMAS CHS, LITTLE GIBBS ROAD, MALABAR HILL MUMBAI MH 400006 India",
                "no_of_shares": 33873,
                "is_director": true,
                "company_type": "",
                "source": "mca",
                "parent": "U65920MH1996PLC101234",
                "level": 2,
                "shareholder_type": "individual",
                "ultimate_ownership_percentage": 3.92
            },
            {
                "shareholder_name": "RAJAS RATANCHAND DOSHI",
                "shareholding_percentage": 67.11,
                "shareholder_dob": "1951-02-11",
                "shareholder_cin": "",
                "shareholder_din": "00050594",
                "shareholder_pan": "AAGPD1234L",
                "shareholder_contact": "",
                "shareholder_email": "rajasrdoshi@gmail.com",
                "shareholder_address": "33, LAS PALMAS CHS, LITTLE GIBBS ROAD, MALABAR HILL MUMBAI MH 400006 India",
                "no_of_shares": 80538,
                "is_director": true,
                "company_type": "",
                "source": "mca",
                "parent": "U67120MH1996PTC101234",
                "level": 3,
                "shareholder_type": "individual",
                "ultimate_ownership_percentage": 38.26
            },
            {
                "shareholder_name": "JYOTI RAJAS DOSHI",
                "shareholding_percentage": 10.86,
                "shareholder_dob": "1953-09-11",
                "shareholder_cin": "",
                "shareholder_din": "00012345",
                "shareholder_pan": "AAEPD1234F",
                "shareholder_contact": "",
                "shareholder_email": "jyoti.doshi@gmail.com",
                "shareholder_address": "33, LAS PALMAS CHS, LITTLE GIBBS ROAD, MALABAR HILL MUMBAI MH 400006 India",
                "no_of_shares": 13032,
                "is_director": true,
                "company_type": "",
                "source": "mca",
                "parent": "U67120MH1996PTC101234",
                "level": 3,
                "shareholder_type": "individual",
                "ultimate_ownership_percentage": 6.19
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Client ID

Authentication Error

Process Pending

Process Failed

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid client_id provided",
    "message_code": "invalid_client_id"
}

This error occurs when the provided client_id is invalid or does not exist in the system.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token rotation and expiration policies

Use HTTPS for all API communications

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement polling with appropriate intervals when checking status of pending requests

Display ownership hierarchy in a visual format (tree/graph) for better understanding

Provide clear explanations of ownership percentages and their significance

Implement caching for frequently accessed UBO data to improve performance

Code Samples

cURL

Python

Node.js

Related APIs

Create UBO Order: Initiates the UBO verification process for a given entity

Get UBO Details: Fetches the complete UBO information for a completed verification

Entity Search: Searches for entities by name or partial identification

Compliance and Legal Considerations

The UBO information retrieved through this API is sourced from official government records and should be used in compliance with applicable data protection and privacy regulations. The information should only be used for legitimate business purposes such as KYC verification, regulatory compliance, or due diligence. Unauthorized use or distribution of this information may violate privacy laws.

{ "data": { "client_id": "mca_ubo_BQgmfkfdFjxqhwRedZqt", "entity_id": "L51500MH9876PLC001234", "entity_type": "company", "status": "completed", "entity_cin": "L51500MH9876PLC001234", "company_name": "THE INDIAN HUME PIPE COMPANY LIMITED", "company_address": "CONSTRUCTION HOUSE WALCHANDHIRACHAND MARG BALLARD ESTATE FORT, MMUMBAI, Maharashtra - 400001", "company_email": "info@indianhumepipe.com", "company_pan": "AAACT1234D", "company_type": "public", "ubo_chain": [ { "shareholder_name": "IHP FINVEST LIMITED", "shareholding_percentage": 65.92, "shareholder_dob": null, "shareholder_cin": "U65920MH1996PLC101234", "shareholder_din": "", "shareholder_pan": "AAACI1234P", "shareholder_contact": "", "shareholder_email": "ihpfinvest@yahoo.co.in", "shareholder_address": "CONSTRUCTION HOUSE, 2ND FLOOR, WALCHAND HIRACHAND MARG, MUMBAI, Maharashtra - 400001", "no_of_shares": null, "is_director": false, "company_type": "private", "source": "mca", "parent": "L51500MH9876PLC001234", "level": 1, "shareholder_type": "company", "ultimate_ownership_percentage": 65.92 }, { "shareholder_name": "RATANCHAND INVESTMENT PRIVATE LIMITED", "shareholding_percentage": 86.49, "shareholder_dob": null, "shareholder_cin": "U61110MH1996PTC101234", "shareholder_din": "", "shareholder_pan": "AABCR1234J", "shareholder_contact": "", "shareholder_email": "ratanchandinvestment@gmail.com", "shareholder_address": "CONSTRUCTION HOUSE2ND FLR WALCHAND HIRACHAND MARG BALLARD EST, MUMBAI, Maharashtra - 400001", "no_of_shares": null, "is_director": false, "company_type": "private", "source": "mca", "parent": "U65920MH1996PLC101234", "level": 2, "shareholder_type": "company", "ultimate_ownership_percentage": 57.01 }, { "shareholder_name": "RAJAS RATANCHAND DOSHI", "shareholding_percentage": 5.94, "shareholder_dob": "1951-01-01", "shareholder_cin": "", "shareholder_din": "00050594", "shareholder_pan": "AAGPD1234L", "shareholder_contact": "", "shareholder_email": "rajasrdoshi@gmail.com", "shareholder_address": "33, LAS PALMAS CHS, LITTLE GIBBS ROAD, MALABAR HILL MUMBAI MH 400006 India", "no_of_shares": 33873, "is_director": true, "company_type": "", "source": "mca", "parent": "U65920MH1996PLC101234", "level": 2, "shareholder_type": "individual", "ultimate_ownership_percentage": 3.92 }, { "shareholder_name": "RAJAS RATANCHAND DOSHI", "shareholding_percentage": 67.11, "shareholder_dob": "1951-02-11", "shareholder_cin": "", "shareholder_din": "00050594", "shareholder_pan": "AAGPD1234L", "shareholder_contact": "", "shareholder_email": "rajasrdoshi@gmail.com", "shareholder_address": "33, LAS PALMAS CHS, LITTLE GIBBS ROAD, MALABAR HILL MUMBAI MH 400006 India", "no_of_shares": 80538, "is_director": true, "company_type": "", "source": "mca", "parent": "U67120MH1996PTC101234", "level": 3, "shareholder_type": "individual", "ultimate_ownership_percentage": 38.26 }, { "shareholder_name": "JYOTI RAJAS DOSHI", "shareholding_percentage": 10.86, "shareholder_dob": "1953-09-11", "shareholder_cin": "", "shareholder_din": "00012345", "shareholder_pan": "AAEPD1234F", "shareholder_contact": "", "shareholder_email": "jyoti.doshi@gmail.com", "shareholder_address": "33, LAS PALMAS CHS, LITTLE GIBBS ROAD, MALABAR HILL MUMBAI MH 400006 India", "no_of_shares": 13032, "is_director": true, "company_type": "", "source": "mca", "parent": "U67120MH1996PTC101234", "level": 3, "shareholder_type": "individual", "ultimate_ownership_percentage": 6.19 } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

UBO Status

UBO Status#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Query Parameters#

Example Request#

Response Parameters#

UBO Chain Object Structure#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

UBO Status

Description

Use Cases

Technical Implementation

Request Headers

Query Parameters

Example Request

Response Parameters

UBO Chain Object Structure

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples