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

# Registry Reports

> Retrieve company registry reports and available documents for business verification and compliance due diligence via the iDenfy API.

<Note>
  **Requirements**

  * **API** key pair
  * Reports functionality **enabled** (done by iDenfy's staff)
</Note>

<Info>
  **Sample reports:** [Download here](/images/preview/ReportSamples.zip)
</Info>

***

## Registry Reports

### Available Registry Report Documents

<Info>
  **Authorization:** `API key pair`
  **Method:** `GET`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-ordered-documents/available-documents/`
</Info>

| Parameter (query)    | Type   | Required | Sample/available values  |
| -------------------- | ------ | -------- | ------------------------ |
| `countryCode`        | String | Yes      | 2-digit ISO country code |
| `registrationNumber` | String | Yes      | "12511182"               |

**Response example**

```json theme={"system"}
{
  "products": [
    {
      "id": "EBROFF_MzA0NjE3NjIxO0xUVV9CUzs0OzQ7RlMwMTI5_TFRVX0JT_QmFsYW5jZSBzaGVldA==_MzA0NjE3NjIx",
      "priceTag": "LTU_BS",
      "price": "0",
      "vatCharge": "0",
      "currency": "\u20ac",
      "productCode": "304617621;LTU_BS;4;4;FS0129",
      "companyCode": "304617621",
      "productDetails": [
        {
          "keyField": "EFFECTIVE_DATE",
          "valueField": "2020-12-31",
          "documentCountField": 0
        }
      ],
      "productFormat": "HTML",
      "productTitle": "Balance sheet",
      "displayDate": "2020-12-31",
      "type": "BALANCE_SHEET",
      "deliveryTimeMinutes": 5,
      "tierCode": "A",
      "tierValue": "1.00",
      "status": "NOT_ORDERED",
      "canOrder": true
    },
    {
      "id": "304617621;LTU_BS;4;7;FS0229",
      "productCode": "304617621;LTU_BS;4;7;FS0229",
      "price": 1,
      "productFormat": null,
      "productTitle": "Balance sheet",
      "deliveryTimeMinutes": 5,
      "type": "BALANCE_SHEET",
      "displayDate": "2023-12-31",
      "priceTag": "LTU_BS",
      "vatCharge": "0",
      "currency": "\u20ac",
      "companyCode": "304617621",
      "productDetails": [
        {
          "keyField": "EFFECTIVE_DATE",
          "valueField": "2020-12-31",
          "documentCountField": 0
        }
      ],
      "productFormat": "HTML",
      "productTitle": "Profit and loss account",
      "displayDate": "2020-12-31",
      "type": "PROFIT_AND_LOSS_ACCOUNT",
      "deliveryTimeMinutes": 5,
      "tierCode": "A",
      "tierValue": "1.00",
      "status": "NOT_ORDERED",
      "canOrder": true
    }
  ]
}
```

***

### Order Registry Report Document

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-ordered-documents/document-order/`
</Info>

| Parameter            | Type   | Required | Sample/available values                                                                                   |
| -------------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------- |
| `countryCode`        | String | Yes      | 2-digit ISO country code                                                                                  |
| `registrationNumber` | String | Yes      | "12511182"                                                                                                |
| `companyName`        | String | Yes      | "Company Name"                                                                                            |
| `productKey`         | String | Yes      | `id` of the document from the [available Registry Reports response](#available-registry-report-documents) |

<Tabs>
  <Tab title="Request">
    ```json theme={"system"}
    {
      "countryCode": "LT",
      "registrationNumber": "304617621",
      "companyName": "IDENFY",
      "productKey": "EBRON_RUJSX0NvbXBhbnlQcm9maWxlXzE=_MzA0NjE3NjIx__"
    }
    ```
  </Tab>

  <Tab title="Response">
    Successful request / 200 OK with empty body.
  </Tab>
</Tabs>

***

### List Ordered Registry Report Documents

<Info>
  **Authorization:** `API key pair`
  **Method:** `GET`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-ordered-documents/`
</Info>

**Response example**

```json theme={"system"}
[
  {
    "id": "39e40532-8838-402b-a72e-ab39d1c43b16",
    "title": "Company Officials",
    "documentFormat": "PDF",
    "productKey": "EBRON_RUJSX0NvbXBhbnlPZmZpY2lhbHNfMQ==_MzA0NjE3NjIx__",
    "expectedDeliveryTime": "2024-01-02T09:51:53.643567Z",
    "price": 1.0,
    "deliveredAt": "2024-01-02T09:52:55.543725Z",
    "status": "FINISHED",
    "file": "https://s3.eu-west-1.amazonaws.com/..."
  },
  {
    "id": "f0733089-c27e-47cb-b49d-e9950097aed2",
    "title": "Beneficial Ownership Report",
    "documentFormat": "PDF",
    "productKey": "ROWOFF_Q1pfVUJP_QmVuZWZpY2lhbCBPd25lcnNoaXAgUmVwb3J0_...",
    "expectedDeliveryTime": "2023-12-14T08:24:18.959072Z",
    "price": 5.0,
    "deliveredAt": "2023-12-14T09:21:58.768875Z",
    "status": "FINISHED",
    "file": "https://s3.eu-west-1.amazonaws.com/..."
  }
]
```

### Retrieve Specific Registry Report Document

<Info>
  **Authorization:** `API key pair`
  **Method:** `GET`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/gov-ordered-documents/{id}/`
  **{id}:** `Report's unique number`
</Info>

**Response example**

```json theme={"system"}
{
  "id": "39e40532-8838-402b-a72e-ab39d1c43b16",
  "title": "Company Officials",
  "documentFormat": "PDF",
  "productKey": "EBRON_RUJSX0NvbXBhbnlPZmZpY2lhbHNfMQ==_MzA0NjE3NjIx__",
  "expectedDeliveryTime": "2023-12-14T08:36:26.033428Z",
  "price": 1.0,
  "deliveredAt": "2024-01-02T09:52:55.543725Z",
  "status": "FINISHED",
  "file": "https://s3.eu-west-1.amazonaws.com/..."
}
```