Documentation
/api/companydata
You can use the test API key during development to build your integration at no cost.
Additional optional request parameters and response properties may be added in the future to support enhancements. Integrations are encouraged to ignore unknown request parameters and gracefully handle any extra response fields. Existing parameters and properties will not be removed or renamed within the same API version.
This API endpoint returns comprehensive company data including financials, profile, officers, and persons with significant control (PSC) for a company using its Companies House registration number.
Request
https://convert-ixbrl.co.uk/api/companydata?companynumber=012345678&apiVersion=2
Method Type
HTTP GET
Authentication
This endpoint requires the authentication header to be supplied. See the authentication section.
Request Parameters
| Parameter | 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 |
Bad request - missing or invalid parameters |
403 |
Paid account required |
429 |
Request throttled for exceeding rate limits |
Response JSON Example
{
"status": "Ok",
"profile": {
"type": "Private Limited Company",
"company_status": "Active",
"company_number": "12345678",
"company_name": "Example Company Limited",
"date_of_creation": "15/06/2018",
"accounts_next_due": "31/12/2025",
"confirmation_statement_next_due": "15/06/2026",
"sic_codes": [
{
"code": "62012",
"description": "Business and domestic software development"
}
],
"registered_office_address": {
"postal_code": "SW1A 1AA",
"address_line_1": "10 Example Street",
"locality": "London",
"country": "England"
}
},
"financials": {
"company_financial_list": [
{
"end_date": "31/03/2024",
"profit_loss": {
"turnover": "2500000.0",
"cost_of_sales": "800000.0",
"administrative_expenses": "450000.0",
"distribution_costs": "120000.0",
"gross_profit_loss": "1700000.0",
"operating_profit_loss": "1130000.0",
"audit_fees": "15000.0",
"profit_loss": "980000.0",
"retained_profits": "1250000.0",
"salaries": "420000.0",
"other_operating_income": "85000.0",
"other_interest_receivable_and_similar_income_finance_income": "25000.0",
"interest_payable_and_similar_charges_finance_costs": "35000.0",
"profit_loss_on_ordinary_activities_before_tax": "1070000.0",
"tax_taxcredit_on_profit_or_loss_on_ordinary_activites": "270000.0",
"depreciation_expense_property_plant_equipment": "65000.0",
"comprehensive_income_expense": "800000.0"
},
"balance_sheet": {
"fixed_assets": "8500000.0",
"intangible_assets": "1200000.0",
"investments": "3500000.0",
"investments_fixed_assets": "3500000.0",
"investment_property": "1800000.0",
"investment_property_fair_value_model": "1800000.0",
"investments_in_subsidiaries": "1500000.0",
"investments_in_group_undertakings": "800000.0",
"investments_in_group_undertakings_participating_interests": "800000.0",
"investments_in_subsidiaries_measured_fair_value": "1500000.0",
"investments_in_joint_ventures": "500000.0",
"investments_in_associates": "300000.0",
"other_investments_other_than_loans": "200000.0",
"disposals_investment_property_fair_value_model": null,
"current_assets": "1850000.0",
"current_asset_investments": "250000.0",
"stock": "320000.0",
"debtors_amounts_falling_due_current": "450000.0",
"trade_debtors_amounts_falling_due_current": "380000.0",
"debtors_amounts_falling_due_non_current": "150000.0",
"trade_debtors_amounts_falling_due_non_current": "120000.0",
"cash": "680000.0",
"total_assets": "10350000.0",
"liabilities": "1850000.0",
"creditors_amounts_falling_due_current": "650000.0",
"trade_creditors_trade_payables_due_current": "420000.0",
"net_current_assets_liabilities": "1200000.0",
"creditors_amounts_falling_due_non_current": "1200000.0",
"trade_creditors_trade_payables_due_non_current": "800000.0",
"total_borrowings": "950000.0",
"loans_from_directors": "280000.0",
"bank_overdrafts": "150000.0",
"bank_overdrafts_current": "150000.0",
"bank_overdrafts_non_current": null,
"accrued_liabilities": "120000.0",
"government_grants_payable": null,
"unpaid_contributions_to_pension_schemes_current": "25000.0",
"unpaid_contributions_to_pension_schemes_non_current": null,
"total_assets_less_current_liabilities": "8500000.0",
"net_assets": "8500000.0",
"shareholders_equity": "8500000.0",
"calledup_share_capital": "5000000.0",
"retained_earnings_accumulated_losses": "3500000.0"
},
"changes_in_equity": {
"retained_earnings_accumulated_losses": "3500000.0",
"share_capital": "5000000.0",
"profit_loss_affecting_equity": "800000.0",
"dividends_paid": "250000.0",
"comprehensive_income_expense": "800000.0"
},
"other_notes_to_financial_statements": {
"employee_count": "25",
"wages_and_salaries": "420000.0",
"social_security_costs": "52000.0",
"pension_costs_defined_contribution_plan": "35000.0",
"pension_other_post_employment_benefit_costs_other_pension_costs": "8000.0",
"audit_fees_expenses": "15000.0",
"fees_for_non_audit_services": "12000.0",
"government_grant_income": "45000.0",
"government_grants_payable": null,
"amount_specific_advance_or_credit_made_in_period_directors": "50000.0",
"amount_specific_advance_or_credit_directors": "280000.0"
},
"cash_flow": {
"interest_expense_on_bank_overdrafts": "8500.0",
"tax_taxcredit_on_profit_or_loss_on_ordinary_activites": "270000.0",
"gain_loss_in_cash_flows_from_change_in_inventories": "-45000.0",
"gain_loss_in_cash_flows_from_change_in_debtors_trade_other_receivables": "-120000.0",
"gain_loss_in_cash_flows_from_change_in_creditors_trade_other_payables": "85000.0",
"net_cash_generated_from_operations": "1120000.0",
"income_taxes_paid_refund_classified_as_operating_activities": "250000.0",
"net_cash_flows_from_used_in_operating_activities": "870000.0",
"purchase_property_plant_equipment": "180000.0",
"proceeds_from_sales_property_plant_Equipment": "45000.0",
"net_interest_received_paid_classified_as_investing_activities": "-10000.0",
"net_cash_flows_from_used_in_investing_activities": "-145000.0",
"dividends_paid_classified_as_financing_activities": "250000.0",
"net_cash_flows_from_used_in_financing_activities": "-260000.0",
"IncreaseDecreaseInCashCashEquivalentsBeforeForeignExchangeDifferencesChangesInConsolidation": "465000.0",
"cash_bank_on_hand": "680000.0",
"cash_bank_on_hand_at_beginning_of_year": "215000.0"
}
},
{
"end_date": "31/03/2023",
"profit_loss": {
"turnover": "2200000.0",
"cost_of_sales": "720000.0",
"administrative_expenses": "400000.0",
"distribution_costs": "110000.0",
"gross_profit_loss": "1480000.0",
"operating_profit_loss": "970000.0",
"audit_fees": "14000.0",
"profit_loss": "850000.0",
"retained_profits": "1100000.0",
"salaries": "380000.0",
"other_operating_income": "75000.0",
"other_interest_receivable_and_similar_income_finance_income": "20000.0",
"interest_payable_and_similar_charges_finance_costs": "30000.0",
"profit_loss_on_ordinary_activities_before_tax": "1020000.0",
"tax_taxcredit_on_profit_or_loss_on_ordinary_activites": "240000.0",
"depreciation_expense_property_plant_equipment": "60000.0",
"comprehensive_income_expense": "780000.0"
},
"balance_sheet": {
"fixed_assets": "7800000.0",
"intangible_assets": "1100000.0",
"investments": "3200000.0",
"investments_fixed_assets": "3200000.0",
"investment_property": "1650000.0",
"investment_property_fair_value_model": "1650000.0",
"investments_in_subsidiaries": "1400000.0",
"investments_in_group_undertakings": "750000.0",
"investments_in_group_undertakings_participating_interests": "750000.0",
"investments_in_subsidiaries_measured_fair_value": "1400000.0",
"investments_in_joint_ventures": "450000.0",
"investments_in_associates": "280000.0",
"other_investments_other_than_loans": "180000.0",
"disposals_investment_property_fair_value_model": null,
"current_assets": "1650000.0",
"current_asset_investments": "220000.0",
"stock": "280000.0",
"debtors_amounts_falling_due_current": "400000.0",
"trade_debtors_amounts_falling_due_current": "340000.0",
"debtors_amounts_falling_due_non_current": "130000.0",
"trade_debtors_amounts_falling_due_non_current": "105000.0",
"cash": "600000.0",
"total_assets": "9450000.0",
"liabilities": "1700000.0",
"creditors_amounts_falling_due_current": "600000.0",
"trade_creditors_trade_payables_due_current": "390000.0",
"net_current_assets_liabilities": "1050000.0",
"creditors_amounts_falling_due_non_current": "1100000.0",
"trade_creditors_trade_payables_due_non_current": "750000.0",
"total_borrowings": "900000.0",
"loans_from_directors": "260000.0",
"bank_overdrafts": "140000.0",
"bank_overdrafts_current": "140000.0",
"bank_overdrafts_non_current": null,
"accrued_liabilities": "110000.0",
"government_grants_payable": null,
"unpaid_contributions_to_pension_schemes_current": "22000.0",
"unpaid_contributions_to_pension_schemes_non_current": null,
"total_assets_less_current_liabilities": "7750000.0",
"net_assets": "7750000.0",
"shareholders_equity": "7750000.0",
"calledup_share_capital": "5000000.0",
"retained_earnings_accumulated_losses": "2750000.0"
},
"changes_in_equity": {
"retained_earnings_accumulated_losses": "2750000.0",
"share_capital": "5000000.0",
"profit_loss_affecting_equity": "780000.0",
"dividends_paid": "230000.0",
"comprehensive_income_expense": "780000.0"
},
"other_notes_to_financial_statements": {
"employee_count": "22",
"wages_and_salaries": "380000.0",
"social_security_costs": "48000.0",
"pension_costs_defined_contribution_plan": "32000.0",
"pension_other_post_employment_benefit_costs_other_pension_costs": "7500.0",
"audit_fees_expenses": "14000.0",
"fees_for_non_audit_services": "11000.0",
"government_grant_income": "40000.0",
"government_grants_payable": null,
"amount_specific_advance_or_credit_made_in_period_directors": "45000.0",
"amount_specific_advance_or_credit_directors": "260000.0"
},
"cash_flow": {
"interest_expense_on_bank_overdrafts": "7800.0",
"tax_taxcredit_on_profit_or_loss_on_ordinary_activites": "240000.0",
"gain_loss_in_cash_flows_from_change_in_inventories": "-40000.0",
"gain_loss_in_cash_flows_from_change_in_debtors_trade_other_receivables": "-110000.0",
"gain_loss_in_cash_flows_from_change_in_creditors_trade_other_payables": "75000.0",
"net_cash_generated_from_operations": "980000.0",
"income_taxes_paid_refund_classified_as_operating_activities": "230000.0",
"net_cash_flows_from_used_in_operating_activities": "750000.0",
"purchase_property_plant_equipment": "165000.0",
"proceeds_from_sales_property_plant_Equipment": "40000.0",
"net_interest_received_paid_classified_as_investing_activities": "-9000.0",
"net_cash_flows_from_used_in_investing_activities": "-134000.0",
"dividends_paid_classified_as_financing_activities": "230000.0",
"net_cash_flows_from_used_in_financing_activities": "-239000.0",
"IncreaseDecreaseInCashCashEquivalentsBeforeForeignExchangeDifferencesChangesInConsolidation": "377000.0",
"cash_bank_on_hand": "600000.0",
"cash_bank_on_hand_at_beginning_of_year": "223000.0"
}
}
]
},
"officers": [
{
"resultNumber": 1,
"status": "Active",
"forename": "John",
"surname": "Smith",
"date_of_birth": {
"month": "05",
"year": "1980"
},
"nationality": "British",
"occupation": "Company Director",
"officer_role": "director",
"resigned_on": null,
"appointed_on": "15/06/2018",
"address": {
"address_line_1": "10 Example Street",
"address_line_2": null,
"country": "England",
"locality": "London",
"postal_code": "SW1A 1AA"
}
}
],
"psc": [
{
"forename": "Jane",
"surname": "Doe",
"title": "Ms",
"resultNumber": 1,
"dateofbirth": {
"month": "08",
"year": "1985"
},
"nationality": "British",
"country_of_residence": "United Kingdom",
"notified_on": "15/06/2018",
"address": {
"address_line_1": "20 Sample Road",
"address_line_2": null,
"country": "England",
"locality": "Manchester",
"postal_code": "M1 1AB"
},
"natures_of_control": [
"ownership-of-shares-50-to-75-percent",
"voting-rights-50-to-75-percent"
]
}
],
"error_message": null
}
Response Properties
| Name | Type | Nullable | Description |
|---|---|---|---|
status |
string | no |
Contains Ok if the request was successful, Error if there was an error.
|
profile |
object | yes | Company profile information including company details, registered address, accounts due dates, confirmation statement, and SIC codes. All properties shown in the sample above. Note: Any property within this object can be null. |
financials |
object | yes | Contains the financial data for the company, where available. Note: Any property within this object can be null. |
financials.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. Note: Any property within array elements can be null. |
financials.company_financial_list[].end_date |
string | no | The financial year end date in "dd/MM/yyyy" format (e.g., 31/12/2020). Note: Any property within this object can be null. |
financials.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. Note: Any property within this object can be null.
|
financials.company_financial_list[].balance_sheet |
object | yes | Balance sheet properties, if available, for the given year, shown in the sample above. Note: Any property within this object can be null. |
financials.company_financial_list[].cash_flow |
object | yes | Cash flow statement properties, if available, for the given year, shown in the sample above. Note: Any property within this object can be null. |
financials.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. Note: Any property within this object can be null. |
financials.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. Note: Any property within this object can be null. |
officers |
array | yes | Array of officer objects, each containing resultNumber, status, forename, surname, officer_role, nationality, occupation, appointed_on (in dd/MM/yyyy format), resigned_on (in dd/MM/yyyy format, if applicable), date_of_birth, and address. All properties shown in the sample above. Note: Any property within array elements can be null. |
psc |
array | yes | Array of PSC objects, each containing forename, surname, title, resultNumber, nationality, country_of_residence, notified_on (in dd/MM/yyyy format), dateofbirth, natures_of_control, and address. All properties shown in the sample above. Note: Any property within array elements can be null. |
error_message |
string | yes | If the request was unsuccessful, this would contain a description of the error where available |
This website only uses cookies essential for its functionality, such as for login and tracking favorite companies.