Documentation
/api/financials
This API endpoint returns the available financials data for a company using its Companies House registration number.
Request
https://convert-ixbrl.co.uk/api/financials?companynumber=012345678&apiVersion=2
Rate limit
This endpoint is rate limited to 1 request per 2 seconds with requests exceeding this limit served with HTTP 429 code. Limit increase requests can be sent to support@convert-ixbrl.co.uk.
Method Type
HTTP GET
Authentication
This endpoint requires the authentication header to be supplied. See the authentication section.
Request Parameters
| companyNumber | Type | Optional | Description |
|---|---|---|---|
apiVersion |
string | No | API Version |
companyNumber |
string | No | Companies House registration number |
HTTP Response codes
| Status Code | Description |
|---|---|
200 |
Successful requests with results |
204 |
Successful requests with no results |
400 |
Authorisation error for when the secret key header is missing or is invalid |
429 |
Request throttled for exceeding rate limits |
Response JSON Example (Only one year's data shown for brevity)
{
"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 if the request was successful, Error if there was an error.
|
errorMessage |
string | yes | If the request was unsuccessful, this would contain a description of the error where available |
lastDataUpdatedDate |
string | no | The date of last data refresh |
result |
object | yes | Contains the financial data for the company, where available |
result.company_financial_list |
array | no | An array where each element contains financial data for a single year. The array will be empty if no financial data is available for instance when a company only files accounts in PDF format. |
company_financial_list[].end_date |
string | no | The financial year end date in "dd/MM/yyyy" format (e.g., 31/12/2020). |
company_financial_list[].profit_loss |
object | yes |
If the company has submitted P&L as part of the IXBRL accounts, this will contain the fields shown against the profit_loss object in the sample above.
|
company_financial_list[].balance_sheet |
object | yes | Balance sheet properties, if available, for the given year, shown in the sample above. |
company_financial_list[].cash_flow |
object | yes | Cash flow statement properties, if available, for the given year, shown in the sample above. |
company_financial_list[].changes_in_equity |
object | yes | Statement of Changes in Equity properties, if available, for the given year, shown in the sample above. |
company_financial_list[].other_notes_to_financial_statements |
object | yes | All data extracted from 'Notes to Financial Statements' section for the given year, shown in the sample above. |
This website only uses cookies essential for its functionality, such as for login and tracking favorite companies.