DOCUMENTATION / FINANCIAL DATA

Company Financial Data: API Field Reference

OpenAPI 3.1 ↗

Explore financial data attributes, statement periods, currencies and exact metric names. Distinguish CompanyProof profiles from the direct provider API.

BASE URLhttps://companyproof.ai/v2JSON · Bearer authentication

FINANCIAL DATA · STRUCTURE & METRICS

Financial statements, down to the attribute.

Start with the CompanyProof profile format, then explore the exact names published for Global Database’s standalone financial APIs.

CompanyProof API
Financials are returned inside the company profile.

GET /v2/companies/{id}/profile returns the profile.financial module when available. It uses reporting periods and named metric groups. There is no standalone CompanyProof /financial route or year filter.

MODULEprofile.financial
REPORTING PERIODSyears[]
STATEMENT GROUPSgroups[]
METRIC VALUESlist[].list[period]

Read values by reporting period

groups[].name identifies the statement. Each entry in groups[].list[] has a metric name and a list object keyed by filing date.

Values in this KYB format are strings or null. Read the Currency, Reporting period and Consolidated A/cs metrics when supplied before comparing figures. Do not assume progress is a financial percentage.

Keep the response shape intact

The module may be direct, wrapped in data, or contain an error. Test for an error before reading its groups.

JSON · illustrative response excerpt
{
  "years": [
    "2024-12-31",
    "2025-12-31"
  ],
  "groups": [
    {
      "id": "Balance Sheet",
      "name": "Balance Sheet",
      "order": 2,
      "list": [
        {
          "name": "Total Assets",
          "list": {
            "2024-12-31": "1200000.00",
            "2025-12-31": "1450000.00"
          }
        }
      ]
    }
  ]
}

CompanyProof financial attributes

17 of 17 entries
Attribute pathTypePresenceDetails
yearsstring[]Required in parentExpand using the nested attributes listed below.
groupsobject[]Required in parentExpand using the nested attributes listed below.
groups[].idinteger | string | nullOptionalReturned field; availability depends on the record.
groups[].namestring | nullOptionalExamples include Summary, Income Statement, Balance Sheet, Cashflow, Capital & Reserves, and KPIs & Ratios.
groups[].orderinteger | number | string | nullOptionalReturned field; availability depends on the record.
groups[].listobject[]OptionalExpand using the nested attributes listed below.
groups[].list[].namestring | nullOptionalReturned field; availability depends on the record.
groups[].list[].listobjectOptionalFinancial values keyed by the returned filing-period string.
groups[].list[].list.{key}string | nullOptionalFinancial values keyed by the returned filing-period string.
groups[].list[].progressnumber[] | nullOptionalExpand using the nested attributes listed below.
sourceobject | nullOptionalExpand using the nested attributes listed below.
source.categoryProfileSourcestring | nullOptionalSource class, such as Government Registry, Enriched or Modelled.
source.commentProfileSourcestring | nullOptionalReturned field; availability depends on the record.
source.idProfileSourceinteger | string | nullOptionalProvider source identifier. Upstream records can encode identifiers as integers or strings.
source.nameProfileSourcestring | nullOptionalReturned field; availability depends on the record.
source.urlProfileSourcestring | nullOptionalSource URL when it can be disclosed; otherwise null. Format: uri.
source.retrieved_atProfileSourcestring | nullOptionalFormat: date-time.

Paths are relative to the selected schema; $ means the schema value itself. Required applies when its parent object exists. null, an absent field and an empty list are different values. Alternative response shapes are labelled.

Metric names shown in the KYB financial example 31 examples

These are examples from the provider’s KYB response, not a fixed list guaranteed for every company.

Reporting periodCurrencyConsolidated A/csEmployee NumbersWorking CapitalTotal LiabilitiesTotal AssetsNet AssetsAmortisation of IntangiblesDepreciation of TangiblesP&L Account ReserveTotal Current AssetsTotal Current LiabilitiesTotal Fixed AssetsTotal Long Term LiabilitiesIntangible AssetsInvestment & OtherTotal Long Term LoansBank LoanTangible AssetsBank OverdraftMiscellaneous Current LiabilitiesTrade CreditorsTrade DebtorsCashBank Overdraft & LTLCapital EmployedBorrowings Due After One YearEquity Paid UpInvestmentsCurrent Ratio
Read the KYB financial source ↗

Full standalone financial attribute catalogue

The two catalogues below belong to Global Database’s direct API and require separate access. They use a different naming and response format from CompanyProof’s KYB financial module.

Global Database direct APIGET /v2/financial/{id}
266 / 266
Exact attribute namePublished typeBrowse category
Reported-Datedate (yyyy-mm-dd)Reporting & company
CurrencystringReporting & company
Total-Other-Long-Term-LiabilitiesdoubleBalance sheet & other
Trade-And-Other-PayablesdoubleBalance sheet & other
Trade-And-Other-ReceivablesdoubleBalance sheet & other
Trade-CreditorsdoubleBalance sheet & other
Trade-Creditors-or-Trade-PayablesdoubleBalance sheet & other
Trade-DebtorsdoubleBalance sheet & other
Trading-AssetsdoubleBalance sheet & other
Trading-LiabilitiesdoubleBalance sheet & other
Treasury-bills-and-other-eligible-billsdoubleBalance sheet & other
TurnoverdoubleIncome statement
Employee-Numbers-YoydoubleRatios & growth
EBITDA-YoydoubleRatios & growth
Accounting-From-DateintReporting & company
Accrued-interest-and-rentdoubleBalance sheet & other
All-Other-IncomedoubleIncome statement
Amortisation-of-IntangiblesdoubleBalance sheet & other
Amounts-owed-to-credit-institutionsdoubleBalance sheet & other
Amounts-owed-to-group-undertakingsdoubleBalance sheet & other
Assets-Held-for-ResaledoubleBalance sheet & other
Audit-FeesdoubleIncome statement
Auditor-FeesdoubleIncome statement
Available-for-sale-financial-assetsdoubleBalance sheet & other
Bank-LoandoubleBalance sheet & other
Bank-OverdraftdoubleBalance sheet & other
Bank-Overdraft-And-LTLdoubleBalance sheet & other
BorrowingsdoubleBalance sheet & other
Borrowings-due-after-one-yeardoubleBalance sheet & other
Borrowings-due-within-one-yeardoubleBalance sheet & other
CFO-To-Sales-RatiodoubleRatios & growth
Capital-EmployeddoubleBalance sheet & other
CashdoubleBalance sheet & other
Cash-Conversion-CycledoubleRatios & growth
Cash-To-Current-Liabilities-RatiodoubleRatios & growth
Cash-To-Total-AssetsdoubleBalance sheet & other
Cash-To-TurnoverdoubleIncome statement
Cash-and-balances-at-central-banksdoubleBalance sheet & other
Cashflow-from-ROIdoubleCash flow
Cashflow-from-Returns-on-InvestmentsdoubleCash flow
Company-Accounts-StatusstringReporting & company
Consolidated-AccountsstringReporting & company
Contingent-LiabilitydoubleBalance sheet & other
Cost-of-SalesdoubleIncome statement
Current-Financial-LiabilitiesdoubleBalance sheet & other
Current-GrantsdoubleBalance sheet & other
Current-Hire-Purchase-CommitmentsdoubleBalance sheet & other
Current-Liabilities-held-for-resaledoubleBalance sheet & other
Current-RatiodoubleRatios & growth
Current-Tax-RecoverabledoubleBalance sheet & other
Customer-Accounts-due-after-1-yeardoubleBalance sheet & other
Customer-Accounts-due-within-1-yeardoubleBalance sheet & other
Customer-accountsdoubleBalance sheet & other
Days-Inventory-OutstandingdoubleRatios & growth
Days-Payable-OutstandingdoubleRatios & growth
Days-Sales-OutstandingdoubleRatios & growth
Debt-Securities-Due-after-1-yeardoubleBalance sheet & other
Debt-Securities-Due-within-1-yeardoubleBalance sheet & other
Debt-Securities-in-IssuedoubleBalance sheet & other
Debt-Securities-in-issue-due-after-1-yeardoubleBalance sheet & other
Debt-Securities-in-issue-due-within-1-yeardoubleBalance sheet & other
Debt-To-CapitaldoubleBalance sheet & other
Employee-NumbersintReporting & company
Employee-RemunerationdoubleRatios & growth
Equity-Paid-UpdoubleBalance sheet & other
Equity-SharesdoubleBalance sheet & other
Exports-YoydoubleRatios & growth
Fees-and-Commission-ExpensedoubleIncome statement
FinancedoubleBalance sheet & other
Finance-CostsdoubleIncome statement
Financial-Assets-CurrentdoubleBalance sheet & other
Financial-Assets-Due-after-1-yeardoubleBalance sheet & other
Financial-Assets-Due-within-1-yeardoubleBalance sheet & other
Financial-Investments-after-12-monthsdoubleBalance sheet & other
Financial-Investments-within-12-monthsdoubleBalance sheet & other
Financial-LiabilitiesdoubleBalance sheet & other
Financial-Liabilities-due-after-1-yeardoubleBalance sheet & other
Financial-Liabilities-due-within-1-yeardoubleBalance sheet & other
Finished-GoodsdoubleBalance sheet & other
Gearing-Gross-Debt-BasisdoubleRatios & growth
Gearing-Liability-BasisdoubleRatios & growth
Gearing-Net-Debt-BasisdoubleRatios & growth
GoodwilldoubleBalance sheet & other
Gross-MargindoubleRatios & growth
Gross-ProfitdoubleIncome statement
Gross-Written-PremiumsdoubleBalance sheet & other
Group-Accounts-PayabledoubleBalance sheet & other
Hire-Purchase-CommitmentsdoubleBalance sheet & other
Human-Capital-Value-AddeddoubleBalance sheet & other
Increase-In-CashdoubleBalance sheet & other
Insurance-Liabilities-to-be-settled-after-12-monthsdoubleBalance sheet & other
Insurance-Liabilities-to-be-settled-within-12-monthsdoubleBalance sheet & other
Insurance-debtors-And-assets-to-be-settled-after-12-monthsdoubleBalance sheet & other
Insurance-debtors-And-assets-to-be-settled-within-12-monthsdoubleBalance sheet & other
Insurance-debtors-and-assetsdoubleBalance sheet & other
Intangible-AssetsdoubleBalance sheet & other
Interest-Bearing-LoansdoubleBalance sheet & other
Interest-Coverage-RatiodoubleRatios & growth
Interest-PayabledoubleBalance sheet & other
Interest-ReceivabledoubleBalance sheet & other
Interest-and-Similar-ExpensedoubleIncome statement
Interest-and-Similar-IncomedoubleIncome statement
Inventory-Turnover-RatiodoubleRatios & growth
Investment-And-OtherdoubleBalance sheet & other
Investment-Expenses-and-ChargesdoubleIncome statement
Investment-IncomedoubleIncome statement
Investment-LiabilitiesdoubleBalance sheet & other
Investment-Liabilities-to-be-settled-after-12-monthsdoubleBalance sheet & other
Investment-Liabilities-to-be-settled-within-12-monthsdoubleBalance sheet & other
InvestmentsdoubleBalance sheet & other
Investments-in-Group-UndertakingsdoubleBalance sheet & other
Items-in-the-course-of-collection-from-other-banksdoubleBalance sheet & other
Items-in-the-course-of-transmission-to-other-banksdoubleBalance sheet & other
Land-And-BuildingsdoubleBalance sheet & other
Lease-CommitmentsdoubleBalance sheet & other
Less-Income-Tax-Attributable-to-Policyholders-ReturnsdoubleIncome statement
Liabilities-held-for-saledoubleBalance sheet & other
Liquidity-RatiodoubleRatios & growth
Loans-And-Deposits-with-Credit-InstitutionsdoubleBalance sheet & other
Loans-after-12-monthsdoubleBalance sheet & other
Loans-and-Advances-to-Banks-Due-after-1-yeardoubleBalance sheet & other
Loans-and-Advances-to-Banks-Due-within-1-yeardoubleBalance sheet & other
Loans-and-Advances-to-Customers-Due-after-1-yeardoubleBalance sheet & other
Loans-and-Advances-to-Customers-Due-within-1-yeardoubleBalance sheet & other
Loans-and-advances-to-banksdoubleBalance sheet & other
Loans-and-advances-to-customersdoubleBalance sheet & other
Loans-within-12-monthsdoubleBalance sheet & other
Long-Term-Hire-Purchase-CommitmentsdoubleBalance sheet & other
Long-Term-Lease-CommitmentsdoubleBalance sheet & other
Miscellaneous-Current-AssetsdoubleBalance sheet & other
Miscellaneous-Current-LiabilitiesdoubleBalance sheet & other
Miscellaneous-LiabilitiesdoubleBalance sheet & other
Net-AssetsdoubleBalance sheet & other
Net-Cash-Flow-before-FinancingdoubleCash flow
Net-Cash-Flow-from-FinancingdoubleCash flow
Net-Cash-Flow-from-OperationsdoubleRatios & growth
Net-Cashflow-before-FinancingdoubleCash flow
Net-Change-In-CashdoubleBalance sheet & other
Net-Debt-To-EBITDA-RatiodoubleRatios & growth
Net-Fees-and-Commission-IncomedoubleIncome statement
Net-Interest-IncomedoubleIncome statement
Net-MargindoubleRatios & growth
Net-Operating-ExpensesdoubleIncome statement
Net-Premiums-EarneddoubleBalance sheet & other
Net-Tax-PaiddoubleBalance sheet & other
Net-WorthdoubleBalance sheet & other
Net-change-in-provision-for-unearned-premiumsdoubleBalance sheet & other
Net-trading-IncomedoubleIncome statement
Non-Current-Directors-LoansdoubleBalance sheet & other
Non-Current-Financial-LiabilitiesdoubleBalance sheet & other
Non-Current-GrantsdoubleBalance sheet & other
Non-Current-Group-Accounts-PayabledoubleBalance sheet & other
Non-Current-Group-LoansdoubleBalance sheet & other
Non-Current-Liabilities-held-for-resaledoubleBalance sheet & other
Non-Current-Other-PayablesdoubleBalance sheet & other
Non-Current-Trade-PayablesdoubleBalance sheet & other
Operating-ExpensesdoubleIncome statement
Operating-ProfitdoubleIncome statement
Operating-Profit-MargindoubleRatios & growth
Other-Assets-due-after-1-yeardoubleBalance sheet & other
Other-Assets-due-within-1-yeardoubleBalance sheet & other
Other-Audit-CostsdoubleIncome statement
Other-Current-Financial-LiabilitiesdoubleBalance sheet & other
Other-InvestmentsdoubleBalance sheet & other
Other-Investments-after-12-monthsdoubleBalance sheet & other
Other-Investments-within-12-monthsdoubleBalance sheet & other
Other-Liabilities-due-after-1-yeardoubleBalance sheet & other
Other-Liabilities-due-within-1-yeardoubleBalance sheet & other
Other-Long-Term-FinancingdoubleBalance sheet & other
Other-Non-Current-AssetsdoubleBalance sheet & other
Other-Non-Current-Financial-LiabilitiesdoubleBalance sheet & other
Other-Non-Insurance-LiabilitiesdoubleBalance sheet & other
Other-Operating-IncomedoubleIncome statement
Other-PayablesdoubleBalance sheet & other
Other-Short-Term-FinancingdoubleBalance sheet & other
Other-Short-Term-LoansdoubleBalance sheet & other
Other-Technical-IncomedoubleIncome statement
Other-creditorsdoubleBalance sheet & other
Other-debtorsdoubleBalance sheet & other
Other-prepayments-and-accrued-incomedoubleCash flow
Outward-reinsurance-premiumsdoubleBalance sheet & other
P-And-L-Account-ReservedoubleBalance sheet & other
Pension-LiabilitiesdoubleBalance sheet & other
PensionsdoubleBalance sheet & other
Plant-And-EquipmentdoubleBalance sheet & other
Pre-Tax-ProfitdoubleIncome statement
Pretax-Profit-MargindoubleRatios & growth
Profit-Before-Tax-attributable-to-shareholdersdoubleIncome statement
Profit-after-TaxdoubleIncome statement
Profit-from-Continuing-Operations-After-TaxdoubleRatios & growth
PropertydoubleBalance sheet & other
Provisions-And-ChargesdoubleBalance sheet & other
Provisions-for-other-risks-and-chargesdoubleBalance sheet & other
Raw-MaterialsdoubleBalance sheet & other
Reinsurance-LiabilitiesdoubleBalance sheet & other
Reinsurance-Liabilities-to-be-settled-after-12-monthsdoubleBalance sheet & other
Reinsurance-Liabilities-to-be-settled-within-12-monthsdoubleBalance sheet & other
Reinsurance-debtors-And-assets-to-be-settled-after-12-monthsdoubleBalance sheet & other
Reinsurance-debtors-And-assets-to-be-settled-within-12-monthsdoubleBalance sheet & other
Reinsurance-debtors-and-assetsdoubleBalance sheet & other
Reinsurance-operationsdoubleRatios & growth
Reinsurers-Share-of-Technical-ProvisionsdoubleBalance sheet & other
Reporting-perioddoubleReporting & company
Retained-ProfitdoubleIncome statement
Return-On-AssetsdoubleRatios & growth
Return-On-Capital-EmployeddoubleRatios & growth
Return-On-EquitydoubleRatios & growth
Revaluation-ReservedoubleBalance sheet & other
Revenue-Per-EmployeedoubleRatios & growth
Share-CapitaldoubleBalance sheet & other
Share-PremiumdoubleBalance sheet & other
Share-Premium-AccountdoubleBalance sheet & other
Share-of-Profit-in-Associates-or-Joint-VenturesstringIncome statement
Shareholder-FundsdoubleBalance sheet & other
Shares-and-other-Variable-Yield-SecuritiesdoubleBalance sheet & other
Stocks-And-Work-in-ProgressdoubleBalance sheet & other
Subordinated-BorrowingsdoubleBalance sheet & other
Subordinated-LiabilitiesdoubleBalance sheet & other
Subordinated-Liabilities-due-after-1-yeardoubleBalance sheet & other
Subordinated-Liabilities-due-within-1-yeardoubleBalance sheet & other
Sundry-ReservesdoubleBalance sheet & other
Tangible-AssetsdoubleBalance sheet & other
Tax-Attributable-to-Policyholders-ReturnsdoubleBalance sheet & other
Tax-Attributable-to-Shareholders-ProfitsdoubleIncome statement
Tax-ExpensedoubleIncome statement
TaxationdoubleIncome statement
Technical-ProvisionsdoubleBalance sheet & other
Total-AssetsdoubleBalance sheet & other
Total-Capital-And-ReservesdoubleBalance sheet & other
Total-Current-AssetsdoubleBalance sheet & other
Total-Current-LiabilitiesdoubleBalance sheet & other
Total-Equity-And-ReservesdoubleBalance sheet & other
Total-Fixed-AssetsdoubleBalance sheet & other
Total-LiabilitiesdoubleBalance sheet & other
Total-Long-Term-HP-And-Lease-CommitmentsdoubleBalance sheet & other
Total-Long-Term-LiabilitiesdoubleBalance sheet & other
Total-Long-Term-LoansdoubleBalance sheet & other
Total-Non-Current-AssetsdoubleBalance sheet & other
Total-Non-Current-HP-And-Lease-CommitmentsdoubleBalance sheet & other
Total-Non-Current-LiabilitiesdoubleBalance sheet & other
Total-Operating-IncomedoubleIncome statement
Total-Other-CreditorsdoubleBalance sheet & other
Debtors-arising-out-of-group-undertakingsdoubleBalance sheet & other
Debtors-arising-out-of-insurance-operationsdoubleRatios & growth
Deferred-Acquisition-CostsdoubleIncome statement
Deposits-by-banksdoubleBalance sheet & other
Deposits-by-banks-due-after-1-yeardoubleBalance sheet & other
Deposits-by-banks-due-within-1-yeardoubleBalance sheet & other
Deposits-received-from-reinsurersdoubleBalance sheet & other
Depreciation-of-TangiblesdoubleBalance sheet & other
Derivative-financial-instrumentsdoubleBalance sheet & other
DerivativesdoubleBalance sheet & other
Derivatives-Due-after-1-yeardoubleBalance sheet & other
Derivatives-Due-within-1-yeardoubleBalance sheet & other
Direct-insurance-operationsdoubleRatios & growth
Directors-RemunerationdoubleRatios & growth
Dividends-PayabledoubleBalance sheet & other
EBITDAdoubleIncome statement
EBITDA-MargindoubleRatios & growth
Wages-And-SalariesdoubleIncome statement
Work-in-ProgressdoubleBalance sheet & other
Working-CapitaldoubleBalance sheet & other
World-TurnoverdoubleIncome statement
Profit-after-Tax-YoydoubleRatios & growth
Turnover-YoydoubleRatios & growth
Total-Liabilities-YoydoubleRatios & growth

Names and types preserve the provider reference exactly, including casing and hyphens. Categories are navigation aids. An attribute appearing in this catalogue does not guarantee a value for every company or year; source nullability and units are not fully specified for every metric.

Source: Global Database Financials API · reviewed 2026-09-08