Report Types Explained
API4ALL v3 offers three company reports. They are cumulative: Structure contains everything in KYB plus company structure, and Credit contains everything in Structure plus ownership chains, negatives, financials, and scoring.
API4ALL v3 offers five company reports. They provide different levels of company information.
| Report | Product code | Endpoint | Best for |
|---|---|---|---|
| KYB | 2100 | /a4a/3.0/api/report/kyb/code/{code} | Onboarding checks, identity and status verification |
| Structure | 2200 | /a4a/3.0/api/report/structure/code/{code} | Ownership and control |
| Credit | 2300 | /a4a/3.0/api/report/credit/code/{code} | Credit decisions, risk exposure, limit setting |
| Structure Report Enhanced | 2700 | /a4a/3.0/api/report/enhanced/code/{code} | Registry history: who held what, and when |
| Corporate Insight Report | 2800 | /a4a/3.0/api/report/cmp/code/{code} | Full company profile without a credit score |
The Structure Report Enhanced is fresh-investigation only. It cannot be ordered from data already on file. See Product Codes.
{
"GeneratedAt": "2026-07-16T09:08:03.113",
"ICGId": "CY00001234406861",
"Company": [ { "GeneralInfo": [] } ]
}KYB Report 2100
2100The KYB (Know Your Business) Report includes the basic identifying information of a company.
Returns
- Registration Number
- Name
- Name In Latin Characters
- VAT Number
- Status
- Date Start
- Legal Type
- Date Registered
- Address
- Date Updated
The address is returned both as a single Address string and broken into its components: City, Street, StreetNumber, Region, Municipality, PostalCode, Country, and CountryCode.
Use KYB when you need to confirm that a company exists, is active, and is who it claims to be.
Structure Report 2200
2200The Structure Report includes all information related to the company's structure, including capital, shareholders, and administrator information.
Returns
| Section | Contains |
|---|---|
GeneralInfo | Identity, status history, company dates, legal type, addresses, website |
MoreInfo | Phones, emails |
Identifiers | Registration number, VAT number, and issue dates |
Names | Current and historic registered names, with start/end dates and status |
Activities | NACE activity codes and descriptions |
Capitals | Issued/nominal shares, nominal price, authorised and paid-up capital |
Administrators | Directors and secretaries, individuals and corporate, with positions |
Shareholders | Shareholders with issued shares, percentage, and share breakdown |
Representations | Representation arrangements |
Branches | Branches of the company |
BranchParent | Parent entity where the subject is itself a branch |
ChamberInfo | Chamber of commerce information |
MortgagesCharges | Registered mortgages and charges, with beneficiary, amount, and dates |
Structure is where you find who controls the company. Both Administrators and Shareholders distinguish individuals from corporate entities via an IsCompany flag, and corporate entries carry their own ICGId so you can pivot to a report on the parent.
Credit Report 2300
2300The Credit Report includes all company information along with a credit score.
Returns everything in Structure, plus:
| Section | Contains |
|---|---|
Administrators → Other Directorship / Other Shareholding | Each administrator's other roles across the register |
Shareholders → Other Directorship / Other Shareholding | Each shareholder's other roles across the register |
Affiliates | Affiliated companies with holding percentage and status |
Subsidiaries | Subsidiary companies with holding percentage and status |
ParentCompany | Immediate parent with holding percentage |
UltimateBeneficialOwner | UBOs with the full OwnershipChain: path, level, percentage, effective % |
Negatives | Bankruptcies and UnpaidBills for the subject company |
CorporateStructureDetrimental | Adverse findings on connected entities: LegalEntities-Status, LegalEntities-Bankruptcies, LegalEntities-UnpaidBills |
StatementOfFinancialPosition | Balance sheet by year. Assets, equity, liabilities |
StatementOfProfitAndLoss | P&L by year: revenue, operating profit, profit for the period |
KeyRatios | Liquidity, profitability, efficiency, leverage, and coverage ratios by year |
ICGScoring | Score, credit limit, and risk description by financial year |
ICG Scoring sample
[
{
"FinancialYear": 2023,
"Score": 46,
"CreditLimit": "25791.25",
"Description": "Above Average",
"Reason": null,
"EstimatedAt": "2026-11-02 11:11:07"
},
{
"FinancialYear": 2022,
"Score": 71,
"CreditLimit": "93629.14",
"Description": "Average",
"Reason": null,
"EstimatedAt": "2026-11-02 11:11:07"
},
{
"FinancialYear": 2021,
"Score": 74,
"CreditLimit": "92945.93",
"Description": "Average",
"Reason": null,
"EstimatedAt": "2026-11-02 11:11:07"
}
]Structure Report Enhanced 2700
2700The Structure Report Enhanced includes the full registry history of a company's officers, shareholders, and share capital. It returns current company information plus every past director, secretary, shareholder, and capital change, with the dates each was in effect.
Available for Cyprus only.
Returns everything in Structure, with historical records added to:
| Section | Contains |
|---|---|
Address | Current and previous addresses |
Capitals | Current and historical share capital, with a narrative of each change |
Administrators | Current and previous directors and secretaries, with the period each served |
Shareholders | Current and previous shareholders, with the period each held |
Corporate Insight Report 2800
2800The Corporate Insight Report includes all company information except the credit score, with in-depth data on shareholders' and directors' relationships.
Available for Cyprus only.
Returns everything in Structure, plus:
| Section | Contains |
|---|---|
Affiliates | Affiliated companies with holding percentage and status |
Subsidiaries | Subsidiary companies with holding percentage and status |
Negatives | Bankruptcies and UnpaidBills for the subject company |
CorporateStructureDetrimental | Adverse findings on connected entities |
StatementOfFinancialPosition | Balance sheet by year: assets, equity, liabilities |
StatementOfProfitAndLoss | P&L by year: revenue, operating profit, profit for the period |
For the meaning, type, and format of each individual field, see Data Definition.
Updated 4 days ago