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 beneficial ownership by enterprise number.

GEThttps://cipc-apm-rs-dev.azure-api.net/sandbox/boreg/enterprise/register/{enterprise_number}

Path parameters

enterprise_number*string

Company registration number

Response

200401404

Success

Headers

Body

application/json

registerarray of object

linksarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://cipc-apm-rs-dev.azure-api.net/sandbox/boreg/enterprise/register/{enterprise_number}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401

{
  "register": [
    {
      "statementid": 0,
      "statementtype": "string",
      "created_on": "string",
      "reference_number": "string",
      "legal_entity_type": "string",
      "company_type": "string",
      "enterprise_name": "string",
      "status": "string",
      "registration_date": "string",
      "total_shares": 0,
      "identifiers": [
        {
          "registration authority": "string",
          "enterprise_number": "string"
        }
      ],
      "publication_details": [
        {
          "publisher_id": "string",
          "publisher": "string",
          "publication_date": "string"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "string",
      "href": "string"
    }
  ]
}

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."

}