Documentation
Documentation menu
API DOCUMENTATION

/api/financials

Request available financial statement data for a company using its Companies House registration number. Results include P&L, balance sheet, cash flow, and notes when available.

Method: GET Auth: API Key Required Version: 2

Version and Endpoint

Version 2 (current) Version 1
https://convert-ixbrl.co.uk/api/financials?companyNumber=012345678&apiVersion=2

You can use the test API key during development to build your integration at no cost.

Request Parameters

Name Type Required Description
apiVersion string No API version selector. Set to 2 for this page.
companyNumber string No Companies House registration number.

HTTP Response Codes

Status Code Description
200 Successful request with results.
204 Successful request with no results.
400 Missing or invalid authentication header.
429 Request throttled for exceeding rate limits.

Response JSON Example

{
    "status": "Ok",
    "result": {
        "company_financial_list": [
           {
          "end_date": "31/03/2024",
          "profit_loss": {
            "turnover": "4500000.0",
            "cost_of_sales": "1800000.0",
            "administrative_expenses": "800000.0",
            "distribution_costs": "250000.0",
            "gross_profit_loss": "2700000.0",
            "operating_profit_loss": "1650000.0",
            "audit_fees": "30000.0",
            "profit_loss": "1200000.0",
            "retained_profits": "1756204.0",
            "salaries": "600000.0",
            "other_operating_income": "150000.0",
            "other_interest_receivable_and_similar_income_finance_income": null,
            "interest_payable_and_similar_charges_finance_costs": "50000.0",
            "profit_loss_on_ordinary_activities_before_tax": "1600000.0",
            "tax_taxcredit_on_profit_or_loss_on_ordinary_activites": "400000.0",
            "depreciation_expense_property_plant_equipment": "100000.0",
            "comprehensive_income_expense": null
          },
          "balance_sheet": {
            "fixed_assets": "11556379.0",
            "intangible_assets": null,
            "investments": "11556379.0",
            "investments_fixed_assets": "11556379.0",
            "investment_property": null,
            "investment_property_fair_value_model": null,
            "investments_in_subsidiaries": null,
            "investments_in_group_undertakings": null,
            "investments_in_group_undertakings_participating_interests": null,
            "investments_in_subsidiaries_measured_fair_value": null,
            "investments_in_joint_ventures": null,
            "investments_in_associates": null,
            "other_investments_other_than_loans": null,
            "disposals_investment_property_fair_value_model": null,
            "current_assets": "337540.0",
            "current_asset_investments": null,
            "stock": "125000.0",
            "debtors_amounts_falling_due_current": "0.0",
            "trade_debtors_amounts_falling_due_current": "112000.0",
            "debtors_amounts_falling_due_non_current": null,
            "trade_debtors_amounts_falling_due_non_current": null,
            "cash": "337540.0",
            "total_assets": "11893919.0",
            "liabilities": "434515.0",
            "creditors_amounts_falling_due_current": "137110.0",
            "trade_creditors_trade_payables_due_current": "90000.0",
            "net_current_assets_liabilities": "200430.0",
            "creditors_amounts_falling_due_non_current": "297405.0",
            "trade_creditors_trade_payables_due_non_current": null,
            "total_borrowings": "250000.0",
            "loans_from_directors": "120000.0",
            "bank_overdrafts": null,
            "bank_overdrafts_current": null,
            "bank_overdrafts_non_current": null,
            "accrued_liabilities": "55000.0",
            "government_grants_payable": null,
            "unpaid_contributions_to_pension_schemes_current": null,
            "unpaid_contributions_to_pension_schemes_non_current": null,
            "total_assets_less_current_liabilities": "11756809.0",
            "net_assets": "11456404.0",
            "shareholders_equity": "11456404.0",
            "calledup_share_capital": "9700000.0",
            "retained_earnings_accumulated_losses": "1756204.0"
          },
          "changes_in_equity": {
            "opening_retained_earnings_accumulated_losses": "555204.0",
            "retained_earnings_accumulated_losses": "1756204.0",
            "share_capital": "9700000.0",
            "profit_loss_affecting_equity": "1200000.0",
            "dividends_paid": null,
            "comprehensive_income_expense": null
          },
          "other_notes_to_financial_statements": {
            "employee_count": "3",
            "wages_and_salaries": "600000.0",
            "social_security_costs": "72000.0",
            "pension_costs_defined_contribution_plan": null,
            "pension_other_post_employment_benefit_costs_other_pension_costs": null,
            "audit_fees_expenses": "30000.0",
            "fees_for_non_audit_services": null,
            "government_grant_income": "50000.0",
            "government_grants_payable": null,
            "amount_specific_advance_or_credit_made_in_period_directors": null,
            "amount_specific_advance_or_credit_directors": null
          },
          "cash_flow": {
            "interest_expense_on_bank_overdrafts": null,
            "tax_taxcredit_on_profit_or_loss_on_ordinary_activites": "400000.0",
            "gain_loss_in_cash_flows_from_change_in_inventories": "-25000.0",
            "gain_loss_in_cash_flows_from_change_in_debtors_trade_other_receivables": "30000.0",
            "gain_loss_in_cash_flows_from_change_in_creditors_trade_other_payables": "-18000.0",
            "net_cash_generated_from_operations": "1450000.0",
            "income_taxes_paid_refund_classified_as_operating_activities": "380000.0",
            "net_cash_flows_from_used_in_operating_activities": "1070000.0",
            "purchase_property_plant_equipment": "250000.0",
            "proceeds_from_sales_property_plant_Equipment": null,
            "net_interest_received_paid_classified_as_investing_activities": null,
            "net_cash_flows_from_used_in_investing_activities": "-250000.0",
            "dividends_paid_classified_as_financing_activities": null,
            "net_cash_flows_from_used_in_financing_activities": "200000.0",
            "IncreaseDecreaseInCashCashEquivalentsBeforeForeignExchangeDifferencesChangesInConsolidation": "102000.0",
            "cash_bank_on_hand": "337540.0",
            "cash_bank_on_hand_at_beginning_of_year": "235540.0"
          }
        }
        ,

        ],
        "title": "EXAMPLE COMPANY LIMTED",
        "isFreeRepeatSearch": false
    },
    "errorMessage": null,
    "lastDataUpdatedDate": "30/05/2025"
}

Response Properties

Name Type Nullable Description
status string No Contains Ok on success and Error on failure.
errorMessage string Yes Error description when the request is unsuccessful.
lastDataUpdatedDate string No Date when financial data was most recently updated in dd/MM/yyyy format.
result object Yes Container for the company financial data where available.
result.company_financial_list array No Financial entries by year, ordered newest first.
company_financial_list[].end_date string Yes Financial year end date in dd/MM/yyyy; null for PDF-only filers.
company_financial_list[].profit_loss object Yes Profit and loss values when submitted in iXBRL.
company_financial_list[].balance_sheet object Yes Balance sheet data for the selected year.
company_financial_list[].cash_flow object Yes Cash flow statement values where available.
company_financial_list[].changes_in_equity object Yes Statement of changes in equity data where available.
company_financial_list[].other_notes_to_financial_statements object Yes Extracted notes-to-financial-statements data.