Skip to main content

KYB Registry Reports

Requirements
  • API key pair
  • Reports functionality enabled (done by iDenfy's staff)
sample reports
Download here

Registry Reports​

Available Registry Reports

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

Available Registry Report documents​

Parameter(query)TypeRequiredSample/available values
countryCodeStringYes2-digit ISO country code, check note above
registrationNumberStringYes"12511182"

Response example​

{
  "products": [
    {
      "id": "EBROFF_MzA0NjE3NjIxO0xUVV9CUzs0OzQ7RlMwMTI5_TFRVX0JT_QmFsYW5jZSBzaGVldA==_MzA0NjE3NjIx",
      "priceTag": "LTU_BS",
      "price": "0",
      "vatCharge": "0",
      "currency": "€",
      "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": "€",
      "productCode": "304617621;LTU_PL;4;4;FS0129",
      "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
    },
    {
      "id": "EBROFF_MzA0NjE3NjIxO0xUVV9CUzs0OzM7RlMwMTI5_TFRVX0JT_QmFsYW5jZSBzaGVldA==_MzA0NjE3NjIx",
      "priceTag": "LTU_BS",
      "price": "0",
      "vatCharge": "0",
      "currency": "€",
      "productCode": "304617621;LTU_BS;4;3;FS0129",
      "companyCode": "304617621",
      "productDetails": [
        {
          "keyField": "EFFECTIVE_DATE",
          "valueField": "2019-12-31",
          "documentCountField": 0
        }
      ],
      "productFormat": "HTML",
      "productTitle": "Balance sheet",
      "displayDate": "2019-12-31",
      "type": "BALANCE_SHEET",
      "deliveryTimeMinutes": 5,
      "tierCode": "A",
      "tierValue": "1.00",
      "status": "NOT_ORDERED",
      "canOrder": true
    }
  ]
}

Order Registry Report document​

Order Registery Report

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

ParameterTypeRequiredSample/available values
countryCodeStringYes2-digit ISO country code, check note above
registrationNumberStringYes"12511182"
companyNameStringYes"Company Name"
productKeyStringYesid of the document from the available Registry Reports response of the previous request
{
  "countryCode": "LT",
  "registrationNumber": "304617621",
  "companyName": "IDENFY",
  "productKey": "EBRON_RUJSX0NvbXBhbnlQcm9maWxlXzE=_MzA0NjE3NjIx__"
}

List ordered Registry Report documents​

List Registry's Reports

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

Response example​

[
  {
    "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/production.users.storage/kyb_storage/partners/2253/ordered_documents/40326ba2-84b5-41b4-810b-3b765a335d24.pdf?AWSAccessKeyId=AKIAJEE33B4FZLU73WMA&Signature=n5fjCoNfcoWKssaypTASA3L%2BJw%3D&Expires=1704192777"
  },
  {
    "id": "f0733089-c27e-47cb-b49d-e9950097aed2",
    "title": "Beneficial Ownership Report",
    "documentFormat": "PDF",
    "productKey": "ROWOFF_Q1pfVUJP_QmVuZWZpY2lhbCBPd25lcnNoaXAgUmVwb3J0_MjYxODU2MTA=___MS8xLzAwMDEgMTI6MDA6MDAgQU0=__S1lDT04=",
    "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/production.users.storage/kyb_storage/partners/2253/ordered_documents/9f97ec5a-df0e-4dd6-834f-9c26982a9b6c.pdf?AWSAccessKeyId=AKIAJEE33B4FZLU73WMA&Signature=np2%2B8JyWK2n0SWIjbnEbUGVm9H%3D&Expires=1704192777"
  }
]

Retrieve specific Registry Report document​

GOV registers Report

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

Response example​

{
  "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/production.users.storage/kyb_storage/partners/2253/ordered_documents/9f93f3de-15c5-45ae-99e3-9e4b72e52925.pdf?AWSAccessKeyId=AKIAJEE33B4FZLU73WMA&Signature=q5WXtPdUJknQmtW5U8wn0At5X4%3D&Expires=1704204453"
}