Documentation
/api/companydata
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.
Method: GET
Auth: API Key Required
Version: 2
Version and Endpoint
https://convert-ixbrl.co.uk/api/companydata?companynumber=012345678&apiVersion=2
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.
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 |
Method Type
HTTP GET
Authentication
This endpoint requires the authentication header to be supplied. See the authentication section.
Response JSON Example
{
"status": "Ok",
"last_financials_updated_date": "30/05/2025",
"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": null,
"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
SIC reference list: /Documentation/v2/SicCodes.
| Name | Type | Nullable | Description |
|---|---|---|---|
status |
string | no | Contains Ok if request was successful, Error if there was an error. |
last_financials_updated_date |
string | no | Date when company financial data was most recently updated, in dd/MM/yyyy format, if company financials data is available. |
profile |
object | yes | Company profile information including company details, registered address, accounts due dates, confirmation statement, and SIC codes. All properties shown in sample above. Note: Any property within this object can be null. |
financials |
object | yes | Contains financial data for 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, ordered latest year first. 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 | yes | The financial year end date in "dd/MM/yyyy" format (e.g., 31/12/2020). This is null when company has not filed iXBRL accounts yet (PDF-only filers). Note: Any property within this object can be null. |
financials.company_financial_list[].profit_loss |
object | yes | If company has submitted P&L as part of IXBRL accounts, this will contain fields shown against profit_loss object in 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 given year, shown in 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 given year, shown in 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 given year, shown in 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 given year, shown in 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 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 sample above. Note: Any property within array elements can be null. |
error_message |
string | yes | If request was unsuccessful, this would contain a description of error where available |
This website only uses cookies essential for its functionality, such as for login and tracking favorite companies.