Company Profile

What kind of data I will get

A company profile API provides an overview of a business, including its financial data, ownership structure, activity, and other relevant information.

Input

Attribute	Type	Description
countryISO	string	Country Code eg. PL, GB
registrationNumber	string	This can be either company Registraton Number or VAT Number.
companyName	string	Company name. Either registrationNumber or companyName must be provided.

{
    "countryIso": "PL",
    "registrationNumber": "5252812929"
}

{
    "countryIso": "PL",
    "companyName": "ORLEN S.A."
}

Kyb

Attribute	Type	Description
companyProfile	Object	Containing company profile information

CompanyProfile

Attribute	Type	Description
status	Integer	Status of the response
success	Boolean	Indicator whether reponse is successful
data	Object	Data DTO containing company profile information

Data

Attribute	Type	Description
companyProfile	Object	Company profile details
screenedBusinesses	Object	Screened business data
screenedIndividuals	Object	Screened individuals data
source	String	Source

CompanyProfile

Attribute	Type	Description
companyProfile	Object	Details of the company profile
lastUpdatedDate	String
lastReviewedDate	String

CompanyProfile

Attribute	Type	Description
activity	Array<Object>	List of activities
addresses	Array<Object>	List of addresses
otherAddresses	Array<Object>	List of other addresses
tradingAddresses	Array<Object>	List of trading addresses
websites	Array<String>	List of websites
sector	String	Sector
companyCode	String	Company code
companyName	String	Company name
registeredCompanyName	String	Registered company name
companyRegistrationNumber	Array<String>	Company registration numbers
allAvailableRegistrationNumbers	Array<Object>	All available company registration numbers
companyEmail	Array<String>	Company emails
legalForm	String	Legal form
companyStatus	String	Company status
registrationDate	String	Registration date
phoneNumber	Array<String>	Phone numbers
vatNumber	String	VAT number
directorAndShareDetails	Object	Director and share details
groupStructure	Object	Group structure
extendedGroupStructure	Object	Extended group structure
creditSummary	Object	Credit summary
financialInformation	Array<Object>	List of financial information
additionalInformation	Object	Additional information
beneficialOwners	Array<Object>	List of beneficial owners
ownershipStructure	Array<Object>	List of ownership structure
countryCode	String	Country Code

Activity

Attribute	Type	Description
code	String	Activity code
description	String	Activity description

Address

Attribute	Type	Description
addressInOneLine	String	Full address in one line
postalCode	String	Postal code
streetNumber	String	Street number
streetName	String	Street name
streetAddress	Object	Street address (object type)
cityAddress	String	City address
postOfficeBox	Object	Post office box (object type)

Registration Number

Attribute	Type	Description
registrationNumber	String	Registration Number
typeDescription	String	Description
typeDnBCode	String	DnB Type Code
registrationNumberClass	Object	Registration Number Class
isPreferredRegistrationNumber	Boolean

Registration Number Class

Attribute	Type	Description
registrationNumber	String	Registration Number
dnbCode	String	DnB Code

DirectorAndShareDetails

Attribute	Type	Description
shareHolders	Array<Object>	List of share holders
directors	Array<Object>	List of directors
shareHolderSummary	Object	Share holder summary

ShareHolder

Attribute	Type	Description
registrationNumber	String	Registration number of the share holder
countryCode	String	Country code of the share holder
name	String	Name of the share holder
address	String	Address of the share holder
postalCode	String	Postal code of the share holder
percentage	Double	Percentage of ownership
currency	String	Currency of ownership
shareType	String	Type of share
shareholderType	String	Type of shareholder
subordinateCompanyCode	String	Subordinate company code
isPartialData	Boolean	Indicates if data is partial
companyCode	String	Company code of the share holder
companyProfile	String	Company profile of the share holder

Director

Attribute	Type	Description
id	String	ID of the director
name	String	Name of the director
position	String	Position of the director
address	String	Address of the director
postalCode	String	Postal code of the director
dateOfBirth	String	Date of birth of the director
nationality	String	Nationality of the director

ShareHolderSummary

Attribute	Type	Description
shareCapital	String	Share capital
currency	String	Currency of share capital

GroupStructure

Attribute	Type	Description
ultimateParent	Object	Ultimate parent company information
immediateParent	Object	Immediate parent company information

GroupStructureParent

Attribute	Type	Description
countryCode	String	Country code of the parent company
companyCode	String	Company code of the parent company
safeNumber	String	SAFE number of the parent company
companyName	String	Name of the parent company
companyType	String	Type of the parent company
companyStatus	String	Status of the parent company
registrationNumber	String	Registration number of the parent company
companyAddress	String	Address of the parent company

ExtendedGroupStructure

Attribute	Type	Description
companyCode	String	Company code of the extended group structure
countryCode	String	Country code of the extended group structure
safeNumber	String	SAFE number of the extended group structure
companyName	String	Name of the extended group structure
registrationNumber	String	Registration number of the extended group structure
address	String	Address of the extended group structure
postalCode	String	Postal code of the extended group structure
latestAnnualAccounts	String	Latest annual accounts of the extended group structure
level	Integer	Level of the extended group structure
companyStatus	String	Status of the extended group structure

CreditSummary

Attribute	Type	Description
currentCreditRating	Object	Current credit rating information
previousCreditRating	Object	Previous credit rating information
latestRatingChangeDate	String	Date of the latest rating change

CreditRating

Attribute	Type	Description
commonValue	String	Common value of the current credit rating
commonDescription	String	Common description of the current credit rating
providerDescription	String	Provider description of the current credit rating
providerValue	Object	Provider value of the current credit rating
creditLimit	Object	Credit limit information

ProviderValue

Attribute	Type	Description
maxValue	String	Maximum value
minValue	String	Minimum value
value	String	Value

CreditLimit

Attribute	Type	Description
currency	String	Currency of the credit limit
value	String	Value of the credit limit

FinancialInformation

Attribute	Type	Description
type	String	Type of financial information
numberOfWeeks	Integer	Number of weeks
currency	String	Currency
consolidatedAccounts	Boolean	Indicates if accounts are consolidated
profitAndLoss	Object	Profit and loss information
otherFinancials	Object	Other financial information
balanceSheet	Object	Balance sheet information
ratios	Object	Ratios information

ProfitAndLoss

Attribute	Type	Description
depreciation	BigDecimal	Depreciation amount
amortisation	BigDecimal	Amortisation amount
otherAppropriations	BigDecimal	Other appropriations amount

OtherFinancials

Attribute	Type	Description
contingentLiabilities	String	Contingent liabilities
workingCapital	BigDecimal	Working capital amount
netWorth	BigDecimal	Net worth amount

BalanceSheet

Attribute	Type	Description
totalTangibleAssets	BigDecimal	Total tangible assets amount
totalIntangibleAssets	BigDecimal	Total intangible assets amount
totalOtherFixedAssets	BigDecimal	Total other fixed assets amount
totalFixedAssets	BigDecimal	Total fixed assets amount
totalInventories	BigDecimal	Total inventories amount
tradeReceivables	BigDecimal	Trade receivables amount
miscellaneousReceivables	BigDecimal	Miscellaneous receivables amount
totalReceivables	BigDecimal	Total receivables amount
cash	BigDecimal	Cash amount
totalCurrentAssets	BigDecimal	Total current assets amount
totalAssets	BigDecimal	Total assets amount
tradePayables	BigDecimal	Trade payables amount
bankLiabilities	BigDecimal	Bank liabilities amount
otherLoansOrFinance	BigDecimal	Other loans or finance amount
miscellaneousLiabilities	BigDecimal	Miscellaneous liabilities amount
totalCurrentLiabilities	BigDecimal	Total current liabilities amount
bankLiabilitiesDueAfter1Year	BigDecimal	Bank liabilities due after 1 year amount
otherLoansOrFinanceDueAfter1Year	BigDecimal	Other loans or finance due after 1 year amount
miscellaneousLiabilitiesDueAfter1Year	BigDecimal	Miscellaneous liabilities due after 1 year amount
totalLongTermLiabilities	BigDecimal	Total long-term liabilities amount
totalLiabilities	BigDecimal	Total liabilities amount
calledUpShareCapital	BigDecimal	Called-up share capital amount
revenueReserves	BigDecimal	Revenue reserves amount
otherReserves	BigDecimal	Other reserves amount
totalShareholdersEquity	BigDecimal	Total shareholders' equity amount

Ratios

Attribute	Type	Description
currentDebtRatio	BigDecimal	Current debt ratio
gearing	BigDecimal	Gearing ratio
equityInPercentage	BigDecimal	Equity in percentage
totalDebtRatio	BigDecimal	Total debt ratio

AdditionalInformation

Attribute	Type	Description
miscellaneous	Object	Miscellaneous information
companyHistory	Array<Object>	List of company history
mortgageSummary	Object	Mortgage summary information
personsWithSignificantControl	Object	Persons with significant control information
ratingHistory	Array<Object>	List of rating history
creditLimitHistory	Array<Object>	List of credit limit history
registeredLandAndProperty	Integer	Number of registered land and property
scoreTiers	Array<Object>	List of score tiers
badDebtDetails	Array<String>	List of bad debt details

Miscellaneous

Attribute	Type	Description
fps	Boolean	Indicates if FPS (Filing of Particulars of a Charge) is present
filingDateOfAccounts	String	Filing date of accounts
accountsDueDate	String	Accounts due date

CompanyHistory

Attribute	Type	Description
date	String	Date of the company history event
description	String	Description of the company history event

MortgageSummary

Attribute	Type	Description
outstanding	BigDecimal	Outstanding mortgage amount
satisfied	BigDecimal	Satisfied mortgage amount

PersonsWithSignificantControl

Attribute	Type	Description
activePSC	Array<Object>	List of active persons with significant control

ActivePSC

Attribute	Type	Description
name	String	Name of the person with significant control
personType	String	Type of the person with significant control
address	String	Address of the person with significant control
countryCode	String	Country code of the person with significant control
kind	String	Kind of the person with significant control
countryOfRegistration	String	Country of registration of the person with significant control
placeRegistered	String	Place registered of the person with significant control
natureOfControl	String	Nature of control of the person with significant control
notifiedOn	String	Date of notification
governingLaw	String	Governing law of the person with significant control
legalForm	String	Legal form of the person with significant control
registrationNumber	String	Registration number of the person with significant control
insertDate	String	Date of insertion

RatingHistory

Attribute	Type	Description
date	String	Date of the rating history event
companyValue	BigDecimal	Value of the company in the rating history
ratingDescription	BigDecimal	Description of the rating in the rating history

CreditLimitHistory

Attribute	Type	Description
date	String	Date of the credit limit history event
companyValue	Object	Value of the company in the credit limit history

CompanyValue

Attribute	Type	Description
currency	String	Currency of the company value
value	Integer	Value of the company

ScoreTiers

Attribute	Type	Description
activityCode	String	Code of the activity
numberOfActivityCode	Integer	Number of the activity code

BeneficialOwner

Attribute	Type	Description
registrationNumber	String	Registration number of the beneficial owner
countryCode	String	Country code of the beneficial owner
name	String	Name of the beneficial owner
address	String	Address of the beneficial owner
postalCode	String	Postal code of the beneficial owner
percentage	String	Percentage ownership of the beneficial owner
currency	String	Currency of ownership
shareType	String	Type of share
shareholderType	String	Type of shareholder
subordinateCompanyCode	String	Subordinate company code
isPartialData	Boolean	Indicates if data is partial
companyCode	String	Company code of the beneficial owner
beneficialOwnershipPercentage	String	Beneficial ownership percentage

OwnershipStructure

Attribute	Type	Description
id	Integer	ID of the ownership structure
level	Integer	Level of the ownership structure
country	String	Country of the ownership structure
entityName	String	Name of the entity in the ownership structure
declaredVsCalculated	String	Declared vs Calculated ownership structure
beneficialOwnershipPercentage	Double	Beneficial ownership percentage in the ownership structure
directOwnership	Double	Direct ownership in the ownership structure
indirectOwnership	Double	Indirect ownership in the ownership structure
legalForm	String	Legal form of the entity in the ownership structure
matchLikelihood	String	Likelihood of match in the ownership structure
relations	Array<Object>	List of relations in the ownership structure

ScreenedData

Attribute	Type	Description
filename	String	Filename of the screened data
jobId	String	Job ID of the screened data

Output Example

{
  "status": 200,
  "success": true,
  "data": {
    "companyProfile": {
      "transactionId": "123456",
      "companyProfile": {
        "activity": [
          {
            "code": "A1",
            "description": "Consulting"
          }
        ],
        "addresses": [
          {
            "addressInOneLine": "123 Main St",
            "postalCode": "12345",
            "streetNumber": "123",
            "streetName": "Main St",
            "streetAddress": null,
            "cityAddress": "Cityville",
            "postOfficeBox": null
          }
        ],
        "companyCode": "ABC123",
        "companyName": "Example Company",
        "registeredCompanyName": "Example Corp",
        "registrationAuthorityCode": "RA123",
        "companyEmail": "[e-mail]",
        "legalForm": "LLC",
        "companyStatus": "Active",
        "registrationDate": "2022-01-01",
        "registrationNumber": "RN123",
        "phoneNumber": "[phone]",
        "vatNumber": "VAT123",
        "directorAndShareDetails": {
          "shareHolders": [
            {
              "registrationNumber": "SH1",
              "countryCode": "US",
              "name": "John Doe",
              "address": "456 Oak St",
              "postalCode": "54321",
              "percentage": 25.5,
              "currency": "USD",
              "shareType": "Ordinary",
              "shareholderType": "Individual",
              "subordinateCompanyCode": null,
              "isPartialData": false,
              "companyCode": "ABC123",
              "companyProfile": "Director"
            }
          ],
          "directors": [
            {
              "id": "D1",
              "name": "Jane Smith",
              "position": "CEO",
              "address": "789 Maple Ave",
              "postalCode": "67890",
              "dateOfBirth": "1980-01-15",
              "nationality": "US"
            }
          ],
          "shareHolderSummary": {
            "shareCapital": 100000.0,
            "currency": "USD"
          }
        },
        "groupStructure": {
          "ultimateParent": {
            "countryCode": "US",
            "companyCode": "XYZ789",
            "safeNumber": "SAFE456",
            "companyName": "Ultimate Corp",
            "companyType": "Corporation",
            "companyStatus": "Active",
            "registrationNumber": "RN456",
            "companyAddress": "789 Oak St"
          },
          "immediateParent": {
            "countryCode": "US",
            "companyCode": "DEF456",
            "safeNumber": "SAFE789",
            "companyName": "Immediate Corp",
            "companyType": "Corporation",
            "companyStatus": "Active",
            "registrationNumber": "RN789",
            "companyAddress": "456 Maple Ave"
          }
        },
        "extendedGroupStructure": {
          "companyCode": "XYZ789",
          "countryCode": "US",
          "safeNumber": "SAFE456",
          "companyName": "Ultimate Corp",
          "registrationNumber": "RN456",
          "address": "789 Oak St",
          "postalCode": "54321",
          "latestAnnualAccounts": "2021-12-31",
          "level": 2,
          "companyStatus": "Active"
        },
        "creditSummary": {
          "currentCreditRating": {
            "commonValue": "AA",
            "commonDescription": "Excellent",
            "providerDescription": "CreditAgency",
            "providerValue": {
              "maxValue": "AAA",
              "minValue": "A",
              "value": "AA"
            },
            "creditLimit": {
              "currency": "USD",
              "value": 1000000.0
            }
          },
          "previousCreditRating": {
            "commonValue": "A",
            "commonDescription": "Good",
            "providerDescription": "CreditAgency",
            "providerValue": {
              "maxValue": "AAA",
              "minValue": "A",
              "value": "A"
            },
            "creditLimit": {
              "currency": "USD",
              "value": 500000.0
            }
          },
          "latestRatingChangeDate": "2022-01-15"
        },
        "financialInformation": [
          {
            "type": "Annual",
            "numberOfWeeks": 52,
            "currency": "USD",
            "consolidatedAccounts": true,
            "profitAndLoss": {
              "depreciation": 5000.0,
              "amortisation": 3000.0,
              "otherAppropriations": 2000.0
            },
            "otherFinancials": {
              "contingentLiabilities": "Yes",
              "workingCapital": 50000.0,
              "netWorth": 150000.0
            },
            "balanceSheet": {
              "totalTangibleAssets": 200000.0,
              "totalIntangibleAssets": 10000.0,
              "totalOtherFixedAssets": 30000.0,
              "totalFixedAssets": 240000.0,
              "totalInventories": 50000.0,
              "tradeReceivables": 30000.0,
              "miscellaneousReceivables": 10000.0,
              "totalReceivables": 40000.0,
              "cash": 20000.0,
              "totalCurrentAssets": 60000.0,
              "totalAssets": 300000.0,
              "tradePayables": 25000.0,
              "bankLiabilities": 50000.0,
              "otherLoansOrFinance": 30000.0,
              "miscellaneousLiabilities": 10000.0,
              "totalCurrentLiabilities": 115000.0,
              "bankLiabilitiesDueAfter1Year": 30000.0,
              "otherLoansOrFinanceDueAfter1Year": 20000.0,
              "miscellaneousLiabilitiesDueAfter1Year": 10000.0,
              "totalLongTermLiabilities": 60000.0,
              "totalLiabilities": 175000.0,
              "calledUpShareCapital": 50000.0,
              "revenueReserves": 30000.0,
              "otherReserves": 20000.0,
              "totalShareholdersEquity": 100000.0
            },
            "ratios": {
              "currentDebtRatio": 0.5,
              "gearing": 0.3,
              "equityInPercentage": 0.4,
              "totalDebtRatio": 0.6
            }
          }
        ],
        "additionalInformation": {
          "miscellaneous": {
            "fps": true,
            "filingDateOfAccounts": "2022-02-01",
            "accountsDueDate": "2022-04-30"
          },
          "companyHistory": [
            {
              "date": "2022-01-01",
              "description": "Company founded"
            }
          ],
          "mortgageSummary": {
            "outstanding": 50000.0,
            "satisfied": 30000.0
          },
          "personsWithSignificantControl": {
            "activePSC": [
              {
                "name": "Alice Johnson",
                "personType": "Individual",
                "address": "123 Pine St",
                "countryCode": "US",
                "kind": "Natural person",
                "countryOfRegistration": "US",
                "placeRegistered": "Cityville",
                "natureOfControl": "Ownership",
                "notifiedOn": "2022-01-10",
                "governingLaw": "US law",
                "legalForm": "Individual",
                "registrationNumber": "RN987",
                "insertDate": "2022-01-05"
              }
            ]
          },
          "ratingHistory": [
            {
              "date": "2022-01-15",
              "companyValue": 200000.0,
              "ratingDescription": 4.5
            }
          ],
          "creditLimitHistory": [
            {
              "date": "2022-01-15",
              "companyValue": {
                "currency": "USD",
                "value": 50000.0
              }
            }
          ],
          "registeredLandAndProperty": 2,
          "scoreTiers": [
            {
              "activityCode": "A1",
              "numberOfActivityCode": 3
            }
          ],
          "badDebtDetails": [
            "Invoice #123 overdue",
            "Loan repayment delay"
          ]
        },
        "beneficialOwners": [
          {
            "registrationNumber": "BO1",
            "countryCode": "US",
            "name": "Bob Smith",
            "address": "789 Elm St",
            "postalCode": "45678",
            "percentage": "20",
            "currency": "USD",
            "shareType": "Preferred",
            "shareholderType": "Individual",
            "subordinateCompanyCode": null,
            "isPartialData": false,
            "companyCode": "ABC123",
            "beneficialOwnershipPercentage": "20"
          }
        ],
        "ownershipStructure": [
          {
            "id": 1,
            "level": 1,
            "country": "US",
            "entityName": "Entity 1",
            "declaredVsCalculated": "Declared",
            "beneficialOwnershipPercentage": 30.5,
            "directOwnership": 10.0,
            "indirectOwnership": 20.5,
            "legalForm": "Corporation",
            "matchLikelihood": "High",
            "relations": [
              {
                "parent": 0,
                "sharePercentage": 100.0
              }
            ]
          }
        ]
      }
    }
  }
}