Search documents and filings

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:

codeField
2 digit ISO code

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

Getting Started

Core Features

Registry Extracts and Filings

Search for the entity (company)

Filing search

Example

Response

Continuation key

Delivery times for documents and filings

​Search for the entity (company)

​Filing search

​Example

​Response

​Continuation key

​Delivery times for documents and filings

Search for the entity (company)

Filing search

Example

Response

Continuation key

Delivery times for documents and filings