This API provides access to official corporate shareholder data, excluding self-reported and annual report information but including historical shareholders. The response includes total paid-in capital, contribution dates, shareholder type, name, lists of subscribed and paid-in capitol contributions, and paid-in capital amounts.

API Functionality

• Query corporate shareholder information using the company's full name, registration number, or Unified Social Credit Code.
• Returns data for a single company.

Usage

Key Parameters

• Endpoint: https://api.businessdata.example/v1/shareholders
• Method: GET

Request Parameters:

Parameter	Required	Description
auth_token	Yes	Authentication token obtained from the provider's platform. This token is static and must be kept confidential.
company_identifier	Yes	The company's full name, registration number, or Unified Social Credit Code.
offset	No	Number of records to skip for pagination. A maximum of 20 records are returned per page.

Response Format: The API returns a JSON object with the following structure:

{
  "status_code": 200,
  "message": "success",
  "data": { ... }
}

• status_code: 200 indicates success; other values indicate an error.
• message: A descriptive success or error message.
• data: A JSON object containing the primary response data.

Response Data Structure

The data object contains a shareholders array. Each element in this array is an object with the following fields:

Field	Type	Description
shareholder_name	String	Name of the shareholder.
is_historical	Integer	Indicates if this is a historical shareholder (e.g., 1 for yes, 0 for no).
shareholder_type	String	Type of shareholder (e.g., "Natural Person", "Corporate Entity").
total_paid_in_capital	String	Total amount of capital paid in by this shareholder.
contribution_date	String	Date of the capital contribution.
person_id	String	Unique identifier for the shareholder if they are a natural person.
enterprise_id	String	Unique identifier for the shareholder if they are a corporate entity.
subscribed_items	Array	List of subscribed capital contributions.
paid_in_items	Array	List of paid-in capital contributions.

Nested Objects:

• subscribed_items Array Elements:

  • date: Contribution date for the subscription.
  • amount: Subscribed capital amount.
  • method: Method of contribution (e.g., monetary, in-kind).
  • total_subscribed: Total subscribed capital.
  • identification_type: Type of identification.
  • identification_number: Shareholder's ID number.

• paid_in_items Array Elements:

  • date: Actual payment date.
  • amount: Paid-in capital amount.
  • method: Method of payment.

Additionally, the data object contains a total_count field indicating the total number of shareholder records available.

Request Example

curl "https://api.businessdata.example/v1/shareholders?auth_token=YOUR_STATIC_TOKEN&company_identifier=Example%20Tech%20Co.%20Ltd.&offset=0"

Response Example

{
  "status_code": 200,
  "message": "success",
  "data": {
    "total_count": 2,
    "shareholders": [
      {
        "shareholder_name": "Zhang Wei",
        "is_historical": 0,
        "enterprise_id": "-",
        "person_id": "a1b2c3d4e5f67890",
        "shareholder_type": "Natural Person",
        "identification_type": "-",
        "identification_number": "-",
        "total_paid_in_capital": "500,000",
        "contribution_date": "2022-05-15",
        "paid_in_items": [
          {
            "date": "2022-05-15",
            "amount": "500,000",
            "method": "Monetary"
          }
        ],
        "subscribed_items": [
          {
            "date": "2022-01-10",
            "amount": "1,000,000",
            "method": "Monetary",
            "total_subscribed": "1,000,000",
            "identification_type": "ID Card",
            "identification_number": "110101199001011234"
          }
        ]
      }
    ]
  }
}

Service Notes

• This is a paid service. Implementing caching for responses is recommended to optimize usage.
• For initial company discovery, this API is designed to be used in conjunction with a separate company search API.