> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search documents and filings

> Find available documents for a company using the filing search API.

## Search for the entity (company)

Follow the [search guide](../search) 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](https://www.iso.org/iso-3166-country-codes.html)

[Filing search API reference](/api-reference/registry-documents/filing-search)

#### Example

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

```curl theme={null}
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](order-documents) from the API.

```json theme={null}
"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 theme={null}
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.

```json theme={null}
{
            "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 ...
```