Trigger shareholder structure

Company Structure

This endpoint returns the shareholder structure of a company.
The recursive_level query parameter determines the depth of shareholder levels the endpoint explores.

{
  "id": "<string>",
  "message": "<string>",
  "title": "<string>",
  "status": "<string>",
  "results": {
    "register_errors": [],
    "company_structure": {
      "name": "<string>",
      "is_company": "<boolean>",
      "is_top_company": "<boolean>",
      "register_number": "<string>",
      "share_capital": "<number>",
      "share_capital_currency": "<string>",
      "shareholders": [
        {
          "name": "<string>",
          "is_company": "<boolean>",
          "register_number": "<string>",
          "register_court": "<string>",
          "city": "<string>",
          "country": "<string>",
          "percentage_share": "<number>",
          "nominal_amount": "<number>",
          "nominal_amount_currency": "<string>",
          "source": "<string>",
          "birth_date": "<string>"
        }
      ]
    },
    "documents": []
  }
}

{
  "id": "<string>",
  "message": "<string>",
  "title": "<string>",
  "status": "<string>",
  "results": {
    "register_errors": [],
    "company_structure": {
      "name": "<string>",
      "is_company": "<boolean>",
      "is_top_company": "<boolean>",
      "register_number": "<string>",
      "share_capital": "<number>",
      "share_capital_currency": "<string>",
      "total_deposit": "<number>",
      "total_deposit_currency": "<string>",
      "general_partners": [
        {
          "name": "<string>",
          "is_company": "<boolean>",
          "register_number": "<string>",
          "register_court": "<string>",
          "country": "<string>",
          "shareholders": [
            {
              "name": "<string>",
              "is_company": "<boolean>",
              "register_number": "<string>",
              "register_court": "<string>",
              "city": "<string>",
              "country": "<string>",
              "percentage_share": "<number>",
              "nominal_amount": "<number>",
              "nominal_amount_currency": "<string>",
              "source": "<string>"
            }
          ],
          "is_general_partner": "<boolean>",
          "source": "<string>"
        }
      ],
      "limited_partners": [
        {
          "name": "<string>",
          "is_company": "<boolean>",
          "register_number": "<string>",
          "register_court": "<string>",
          "city": "<string>",
          "country": "<string>",
          "percentage_share": "<number>",
          "nominal_amount": "<number>",
          "nominal_amount_currency": "<string>",
          "is_limited_partner": "<boolean>",
          "source": "<string>"
        }
      ]
    },
    "documents": []
  }
}

{
  "id": "<string>",
  "message": "<string>",
  "title": "<string>",
  "status": "<string>",
  "results": {
    "register_errors": [],
    "company_structure": {
      "name": "<string>",
      "is_company": "<boolean>",
      "is_top_company": "<boolean>",
      "register_number": "<string>",
      "total_deposit": "<number>",
      "total_deposit_currency": "<string>",
      "general_partners": [
        {
          "name": "<string>",
          "is_company": "<boolean>",
          "city": "<string>",
          "country": "<string>",
          "is_general_partner": "<boolean>",
          "source": "<string>",
          "birth_date": "<string>"
        }
      ],
      "limited_partners": [
        {
          "title": "<string>",
          "name": "<string>",
          "is_company": "<boolean>",
          "city": "<string>",
          "country": "<string>",
          "percentage_share": "<number>",
          "nominal_amount": "<number>",
          "nominal_amount_currency": "<string>",
          "is_limited_partner": "<boolean>",
          "source": "<string>",
          "birth_date": "<string>"
        }
      ]
    },
    "documents": []
  }
}

Authorizations

X-API-Key

string

header

required

Query Parameters

company_name

string

required

job_title

string | null

city

string | null

register_number

string | null

user_id

string | null

recursive_level

integer | null

default:0

Response

200

application/json

Successful Response

message

string

required

job_id

string

required

API Documentation

Job Endpoints 📊

Watchlist Endpoints 👀

Trigger shareholder structure

Company Structure

Authorizations

Query Parameters

Response