company-v1

Search documents and filings

Find available documents for a company

Search for the entity (company)

Follow the search guide to find the entity. A valid search confirms whether the entity is active and provides a unique identifier for the company in codeField. The codeField can then be used to perform a filing search.

Filing search

To retrieve a list of available filings from the registry, the following variables are needed:

[ Filing search API reference ]

Example

Below are examples of two filings for a company found using the following search filings request.

curl --location 'https://rest.kyckr.com/core/filing/search/GB/11655290' \
--header 'Authorization: {{apiKey}}'

Response

This is a list of documents that can then be ordered from the API.

"productsField": [
        {
            "idField": "CHON_Q0hfQ29tcGFueU1vcnRnYWdlc18x_MTE2NTUyOTA=",
            "priceTagField": "CH_CM",
            "priceField": "0",
            "vatChargeField": "0",
            "currencyField": "€",
            "productCodeField": "CH_CompanyMortgages_1",
            "companyCodeField": "11655290",
            "productFormatField": "PDF",
            "productTitleField": "Company Mortgages",
            "tierCodeField": "A",
            "tierValueField": "1.00"
        },
        {
            "idField": "CHON_Q0hfQ29tcGFueU9mZmljaWFsc18x_MTE2NTUyOTA=",
            "priceTagField": "CH_CO",
            "priceField": "0",
            "vatChargeField": "0",
            "currencyField": "€",
            "productCodeField": "CH_CompanyOfficials_1",
            "companyCodeField": "11655290",
            "productFormatField": "PDF",
            "productTitleField": "Company Officials",
            "tierCodeField": "A",
            "tierValueField": "1.00"
        }
        ... rest of response ...

Each document will have the following information:

Field Meaning
idField Unique product key for this document
productCodeField Code from registry
companyCodeField Company Code
productFormatField Confirmation of the format of the document
productTitleField Detail from the registry on what the document is
tierValueField The cost in Kyckr Credits to order the Document

Continuation key

The continuationKeyField is supplied when there are multiple pages of results. This key can be passed in as a parameter to load the next page.

curl --location 'https://rest.kyckr.com/core/filing/search/GB/11655290?ContinuationKey=FILL_IN_KEY_HERE' \
--header 'Authorization: {{apiKey}}'

Delivery times for documents and filings

When ordering documents and filings, some documents, such as company profile, can be retrieved in real-time.

However, documents requiring manual retrieval by the Kyckr operations team are subject to a slight delay between order and delivery. Delivery times can be found on the FilingSearch API call, in the response you’ll find deliveryTimeMinutesField for each document and filings. Close to 90% of available documents are delivered within 15 minutes or less.

{
            "idField": "CHOFF_R0JfQ0hfRE9D_KipEaXJlY3RvcidzIGRldGFpbHMgY2hhbmdlZCoqIGZvciBNcyBKZWthdGVyaW5hIE1hbG92IG9uIDIwMjItMTEtMTE=_MTE2NTUyOTA=_UjZ3ai1LWFUwRnN2bER6OEEzWmRPN2pYalROX1lxdTlHczlpX2Z0ZGJEYw==",
            "priceTagField": "GB_CH_DOC",
            "priceField": "0",
            "vatChargeField": "0",
            "currencyField": "€",
            "companyCodeField": "11655290",
            "productDetailsField": [
                {
                    "keyField": "EFFECTIVE_DATE",
                    "valueField": "2022-11-11",
                    "documentCountField": 0
                }
            ],
            "productFormatField": "PDF",
            "productTitleField": "**Director's details changed** for Ms Jekaterina Malov on 2022-11-11",
            "displayDateField": "2022-11-11",
            "typeField": "CH01",
            "deliveryTimeMinutesField": "5",
            "tierCodeField": "A",
            "tierValueField": "1.00"
            ... rest of response ...