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

# Order documents

> Order a document for a company using the product order API.

The [product order](/api-reference/registry-documents/product-order) call allows ordering filings from the registry. This POST call requires details to be provided in the body.

To order a filing from the registry, the following variables are needed:

#### Required fields

* 2 digit [ISO code](https://www.iso.org/iso-3166-country-codes.html)
* `productKey` (the `idField` from the search)

#### Optional

* companyName
* orderRef

[Product order API reference](/api-reference/registry-documents/product-order)

### Order Reference

To help organise all orders, provide a reference for each order placed. This order reference appears in the response when the order is placed and can be used to retrieve the document at a later date.

#### Example

The below example uses a an order reference.

```curl theme={null}
curl --location 'https://rest.kyckr.com/core/filing/order' \
--header 'Authorization:{{apiKey}}' \
--header 'Content-Type: application/json' \
--data '{
    "countryISO": "GB",
    "productKey": "CHON_Q0hfQ29tcGFueU1vcnRnYWdlc18x_MTE2NTUyOTA=",
    "companyName": "Kyckr UK LTD",
    "orderRef": "Example 1"
}'
```

| Field         | Description                                                           |
| ------------- | --------------------------------------------------------------------- |
| `countryIso`  | ISO of jurisdiction for document required                             |
| `productKey`  | `idField` from Filing Search                                          |
| `companyName` | Name of company                                                       |
| `orderRef`    | Your reference for this order (can be used to retrieve order details) |

#### Response

Requesting the document using this POST returns a response confirming the order was successful.

```json theme={null}
{
    "Result": true,
    "Message": "Order Successful",
    "orderRef": "Example 1"
}
```