API Documentation
  • ๐Ÿ‘‹Welcome
  • ๐ŸšฆGetting Started
    • ๐Ÿ–ฅ๏ธEnvironment setup
    • ๐Ÿ‘จโ€๐Ÿ’ปSign up on portal
    • Subscribe to APIs
    • ๐Ÿ“–Terminology
    • ๐Ÿ”Authorization
  • ๐Ÿ’ฒPRICING
    • Subscription
  • API Documentation
    • Companies API reference
      • Companyprofile
      • Information
      • Appointments
      • Directors
      • Employee verification
      • Registered office address
      • Filing history
    • BO API reference
      • Entity statement
      • Ownership or control statement
      • Natural person statement
      • Supporting documents
      • Individual document
  • Specification
  • USER GUIDE
    • For Data Consumers
Powered by GitBook
On this page

Was this helpful?

  1. API Documentation
  2. BO API reference

Ownership or control statement

This endpoint makes an HTTP GET request to retrieve ownership and control information for a specific individual identified by the provided ID.

Last updated 1 year ago

Was this helpful?

The response will contain details about the ownership, including statement ID, type, creation and modification timestamps, full name, interests, and publication details.

The response will be in JSON format with an array of ownership objects, each containing the mentioned details, along with an array of links.

ownership-control

get

Get ownership or control statement by statement Id.

Authorizations
Path parameters
statementidinteger ยท enumRequired

Ownershipr or control statement id

Possible values:
Responses
200
Success
application/json
401
Unauthorised
404
Resource Not Found
application/json
get
GET /sandbox/boreg/ownership-control/{statementid} HTTP/1.1
Host: cipc-apm-rs-dev.azure-api.net
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*
{
  "ownership": [
    {
      "statementid": 97,
      "statementtype": "OwnershipOrControlStatement",
      "describedbypersonstatement": 76,
      "describedbyentitystatement": 4,
      "created_on": "2023-04-14T16:19:00.0000000+00:00",
      "interests": [
        {
          "interest_type": "Shareholding/Beneficial Ownership",
          "share": 17,
          "voting_rights": 0
        }
      ],
      "publication_details": [
        {
          "effective_date": "0001-01-01"
        }
      ],
      "modified_on": "2023-10-13T14:08:21.0000000+00:00"
    },
    {
      "statementid": 98,
      "statementtype": "OwnershipOrControlStatement",
      "describedbypersonstatement": 77,
      "describedbyentitystatement": 4,
      "created_on": "2023-04-14T16:23:39.0000000+00:00",
      "interests": [
        {
          "interest_type": "Trustee of a trust",
          "share": 0,
          "voting_rights": 0
        }
      ],
      "publication_details": [
        {
          "effective_date": "2018-01-10"
        }
      ],
      "modified_on": "2023-10-13T14:06:45.0000000+00:00"
    },
    {
      "statementid": 99,
      "statementtype": "OwnershipOrControlStatement",
      "describedbypersonstatement": 78,
      "describedbyentitystatement": 4,
      "created_on": "2023-04-14T16:30:45.0000000+00:00",
      "interests": [
        {
          "interest_type": "Shareholding/Beneficial Ownership",
          "share": 46,
          "voting_rights": 0
        }
      ],
      "publication_details": [
        {
          "effective_date": "0001-01-01"
        }
      ],
      "modified_on": "2023-10-13T14:09:15.0000000+00:00"
    }
  ],
  "links": [
    {
      "rel": "collection",
      "href": "/ownership-control/"
    }
  ]
}