Entity statement

This HTTP GET request retrieves the registration details of an enterprise based on the provided enterprise number.

The response is in JSON format and includes information such as statement ID, type, creation date, reference number, legal entity type, company type, enterprise name, status, registration date, total shares, identifiers, publication details, and links.

The response will contain an array of "register" objects, each representing the registration details of an enterprise, along with a "links" array providing related hyperlinks.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>
Ocp-Apim-Subscription-Key	<api key>

beneficial-ownership-register

get

Get beneficial ownership by enterprise number.

Authorizations

apiKeyHeaderapiKeyQuery

Path parameters

enterprise_numberstringrequired

Company registration number

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cipc-apm-rs-dev.azure-api.net/sandbox/boreg/enterprise/register/{enterprise_number}' \
  --header 'Ocp-Apim-Subscription-Key: YOUR_API_KEY'

200

401

404

200

{
  "register": [
    {
      "statementid": 4,
      "statementtype": "entityStatement",
      "created_on": "2023-04-03T07:49:37.0000000+00:00",
      "reference_number": "60000705245",
      "legal_entity_type": "Private Company",
      "company_type": "NON-AFFECTED COMPANY WITH BENEFICIAL OWNERSHIP",
      "enterprise_name": "FLUIDROCK GOVERNANCE ACADEMY",
      "status": "BO COMPLETE REGISTRATIONS",
      "registration_date": "2013-09-10",
      "total_shares": 46,
      "identifiers": [
        {
          "registration authority": "ZA-CIPC",
          "enterprise_number": "2013/187505/07"
        }
      ],
      "publication_details": [
        {
          "publisher_id": "AN0790",
          "publisher": "AN0790",
          "publication_date": "2023-03-04"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "collection",
      "href": "/enterprise/register/4"
    }
  ]
}

Success

Response example:

200

"register": [
        {
            "statementid": 4,
            "statementtype": "entityStatement",
            "created_on": "2023-04-03",
            "reference_number": "60000705245",
            "legal_entity_type": "Private Company",
            "company_type": "NON-AFFECTED COMPANY WITH BENEFICIAL OWNERSHIP",
            "enterprise_name": "CIPC LTD",
            "status": "Complete",
            "registration_date": "2013-10-06",
            "total_shares": 46,
            "identifiers": [
                {
                    "registration authority": "ZA-CIPC",
                    "enterprise_number": "2013/187505/07"
                }
            ],
            "publication_details": [
                {
                    "publisher_id": "CIP123",
                    "publisher": "Sello Ndhlovu",
                    "publication_date": 2023-03-31"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "collection",
            "href": "../enterprise/register/"
        }
    ]
}

401

{
    "statusCode": 401,
    "message": "Unauthorized. Access token is missing or invalid."
}

404

{

"statusCode": 404,
"message": "Resource Not Found."

}