Documentation
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.