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 nest: each one contains everything in the report above it, then adds to it.
| 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 |
| Enhanced Structure | 2700 | Registry history1: who held what, and when | |
| Comprehensive | 2800 | Full company profile without a credit score |
Structure contains everything in KYB. From there the range splits in two directions:
- Enhanced Structure adds depth in time: the full registry history of officers, shareholders, and share capital.
- Comprehensive adds breadth: group relationships, adverse findings, and financials. Credit is Comprehensive plus the ICG credit score.
The Enhanced Structure Report is fresh-investigation only. It cannot be ordered from data already on file. See Product Codes.
All five share the same envelope: a GeneratedAt timestamp, the ICGId of the subject company, and a Company array containing the report sections.
{
"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 without the cost or payload of a full structure or credit file.
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 |
Enhanced Structure Report 2700
2700The Enhanced Structure Report 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 |
|---|---|
Names | Current and previous registered names |
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 |
Where Structure answers who controls the company now, Enhanced Structure answers who controlled it, and when it changed. Use it for retrospective due diligence, litigation support, and reconstructing ownership as at a past date.
Comprehensive Report 2800
2800The Comprehensive 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 |
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 |
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 |
For the meaning, type, and format of each individual field, see Data Definition.
Updated 4 days ago