We provide high-quality REST API for every our service. Response provided as JSON object.
You can start integrating data into your app or website as soon as you want. No additional registration or auth key required.
Next section's provide examples and available routes for our projects
{ "companies": [ { "code": "08209948", "name": "! LTD", "address_line1": "METROHOUSE 57 PEPPER ROAD", "address_line2": "HUNSLET", "post_town": "LEEDS", "post_code": "LS10 2RU", "company_category": "Private Limited Company", "company_status": "Active", "country_of_origin": "United Kingdom", "incorporation_date": "2012-09-11 00:00:00", "account_category": "DORMANT", "sic": "99999 - Dormant Company", "last_update": "2020-01-04 19:53:39" } ] }
| q | Search query - should be company name or company code |
|---|---|
| items_per_page | Items displayed per one response page. Has limit of maximum of 100 per page. |
| start_index | Page - starting from 0. |
| real_estate_holders | True or false - Display real estate holders companies. |
| download | If true forms xls file wraps it to zip and returns in Stream response. Will start download immediately as query completed. |
{ "page_index": 10, "items_per_page": 2, "items_count": 2, "companies": [ { "code": "10999200", "name": "THE MIDLANDS ENGINE PORTFOLIO 1 LTD", "address_line1": "Unit 306 Vanilla Factory 39 Fleet Steet", "country": "England", "post_code": "L1 4AR", "company_category": "Private Limited Company", "company_status": "Active", "incorporation_date": "2017-10-05 00:00:00", "account_category": "NO ACCOUNTS FILED", "sic_code1": "68100 - Buying and selling of own real estate", "last_update": "2020-03-14 15:17:48" }, { "code": "10999958", "name": "MSL (47) LTD", "address_line1": "73a London Road", "country": "United Kingdom", "post_code": "SK9 7DY", "company_category": "Private Limited Company", "company_status": "Active", "incorporation_date": "2017-10-06 00:00:00", "account_category": "NO ACCOUNTS FILED", "sic_code1": "68100 - Buying and selling of own real estate", "last_update": "2020-03-15 13:50:33" } ] }
{ "company": { "code": "00617987", "name": "HSBC HOLDINGS PLC", "address_line1": "8 CANADA SQUARE", "post_town": "LONDON", "post_code": "E14 5HQ", "company_category": "Public Limited Company", "company_status": "Active", "country_of_origin": "United Kingdom", "incorporation_date": "1959-01-01 00:00:00", "account_ref_day": 31, "account_ref_month": 12, "next_due_date": "2020-06-30 00:00:00", "last_made_up_date": "2018-12-31 00:00:00", "account_category": "GROUP", "returns_next_due_date": "2017-07-28 00:00:00", "returns_last_made_up_date": "2016-05-31 00:00:00", "num_mort_charges": 0, "num_mort_outstanding": 0, "num_mort_part_satisfied": 0, "num_mort_satisfied": 0, "sic_code1": "70100 - Activities of head offices", "num_gen_partners": 0, "num_lim_partners": 0, "previous_company_name1": "VERNAT TRADING CO. LIMITED", "previous_condate2": "1959-01-01", "previous_company_name2": "VERNAT EASTERN AGENCIES LIMITED", "previous_condate3": "1959-02-10", "previous_company_name3": "SILOM LIMITED", "previous_condate4": "1981-08-13", "previous_company_name4": "HSBC Holdings Plc", "previous_condate5": "1990-12-12", "post_code_f": "E", "post_code_s": "E14", "visible": true, "coordinates": "51.505505@-0.0179999", "last_update": "2020-01-04 19:53:39" } }
{ "finance": { "2014": { "accrued_expenses": 205938, "administrative_expenses": 3089524, "amount_advanced": 160723, "amount_falling_due": 12, "amount_owed_to_group": 514086, "amount_repaid": -228943, "bank_interest": 139, "cash_in_bank": 220705, "corporation_tax": 34078, "cost_of_sales": 13187719, "current_assets": -452444, "current_liabilities": 2980180, "deffered_tax": 105090, "disposals": -62329, "distribution_costs": 178070, "dividends": -450000, "gross_profit": 3354845, "intangible_assets": 8, "interest_received": 462, "investments": 10, "net_worth": 2875090, "operational_profit_or_loss": 96424, "other_debtors": 21347, "other_operational_income": 9173, "prepayments": 88522, "provisions_for_liabilities": 13, "shareholders_funds": 19, "tangible_assets": 3101030, "tax": -18730, "tax_on_profit": 29020, "total_current_tax": 34130, "trade_creditors": 4330, "trade_debtors": 11, "turnover": 16542564, "wages_and_salaries": 1198832, "year_profit": 412754 } } }
{ "contact": { "code": "04508574", "linkedin": "https://www.linkedin.com/company/skyline-accessories-limited", "title": "Skyline Accessories | Tulsa FAA-Certified Repair Station", "url": "http://skylineaccessories.com/", "email": "sales@skylineacc.com", "facebook": "https://www.facebook.com/Skyline-Accessories-Limited-331479623819/" } }
{ "psc": { "code": "04508574", "active_count": 1, "ceased_count": 0, "items": [ { "natures_of_control": [ "ownership-of-shares-75-to-100-percent" ], "country_of_residence": "England", "name": "Mr Friduddin Rana", "address": { "address_line_2": "Manchester", "address_line_1": "33a Moulton Street", "postal_code": "M8 8FJ" }, "kind": "individual-person-with-significant-control", "date_of_birth": { "year": 1971, "month": 11 }, "name_elements": { "title": "Mr", "forename": "Friduddin", "surname": "Rana" }, "nationality": "British", "notified_on": "2016-04-06" } ], "total_results": 1 } }
{ "mortgage": { "code": "04508574", "part_satisfied_count": 0, "items": [ { "delivered_on": "2004-08-11", "classification": { "description": "Debenture", "type": "charge-description" }, "status": "outstanding", "created_on": "2004-08-05", "transactions": [ { "delivered_on": "2004-08-11", "filing_type": "create-charge-pre-2006-companies-act" } ], "secured_details": { "description": "All monies due or to become due from the company to the chargee on any account whatsoever", "type": "amount-secured" }, "particulars": { "type": "short-particulars", "description": "Fixed and floating charges over the undertaking and all property and assets present and future including goodwill bookdebts uncalled capital buildings fixtures fixed plant and machinery." }, "persons_entitled": [ { "name": "Hsbc Bank PLC" } ], "charge_number": 1 } ], "satisfied_count": 0, "total_count": 1, "unfiltered_count": 1 } }
{ "directors": [ { "code": "04508574", "address_line_1": "159 159 Bury New Road", "locality": "Manchester", "postal_code": "M25 9PJ", "region": "Lancashire", "appointed_on": "2007-07-31", "name": "RANA, Friduddin", "officer_role": "secretary", "post_code_first": "M25", "last_update": "2017-01-01 00:00:00", }, { "code": "04508574", "address_line_1": "159 159 Bury New Road", "locality": "Manchester", "postal_code": "M25 9PJ", "region": "Lancashire", "appointed_on": "2003-06-02", "country_of_residence": "United Kingdom", "date_of_birth": "1971-11-01", "name": "RANA, Friduddin", "nationality": "British", "occupation": "Director", "officer_role": "director", "post_code_first": "M25", "last_update": "2017-01-01 00:00:00", } ] }
{ "rating": { "code": "04508574", "rating": 215, "rating_description": "Poor" } }
All parameters for search are optional. You can perform request without any params specified.
| postcode | Postcode of property to search. Space character is required between postcode parts. |
|---|---|
| city | City of searchable property - must be full city name |
| street | Street of property - may be only starting part |
| price_equals | Search by last_sold_price that equals to a given value |
| price_greater | Search by last_sold_price that greater to a given value |
| price_lower | Search by last_sold_price that lower to a given value |
| sold_date_equals | Search by last_sold_date that equals to a given value. Must be in Y-m-d (Example: 2020-01-31) format. |
| sold_date_greater | Search by last_sold_date that greater to a given value. Must be in Y-m-d (Example: 2020-01-31) format. |
| sold_date_lower | Search by last_sold_date that lower to a given value. Must be in Y-m-d (Example: 2020-01-31) format. |
| items_per_page | Items displayed per one response page. Has limit of maximum of 100 per page. |
| start_index | Page - starting from 0. |
{ "properties": [ { "id": 134962, "city": "Luton", "street": "ELMWOOD CRESCENT", "house": "-1", "country": "UK", "postcode": "LU2 7HX", "created_at": "2019-02-16 10:01:35", "updated_at": null, "type": "S", "bedrooms": 3, "price": 350000, "last_sold_price": null, "last_sold_date": null } ] }
| lng | Longitute of searchable property in London. Required |
|---|---|
| lat | Latitude of searchable property in London. Required |
{ "closest": [ { "city": "London", "street": "WINCHMORE HILL ROAD", "house_no": "178", "country": "UK", "postcode": "N21 1QP", "type": "S", "bed": 5, "price": 1053200, "distance": 0 } ] }
{ "object": [ { "t": { "Status": "Taxed", "Tax due": "01 December 2019", "Vehicle make": "MERCEDES", "Date of first registration": "June 2008", "Year of manufacture": "2008", "Cylinder capacity (cc)": "1498 cc", "CO₂Emissions": "148 g/km", "Fuel type": "PETROL", "Euro Status": "Not available", "Export marker": "No", "Vehicle status": "Tax not due", "Vehicle colour": "SILVER", "Vehicle type approval": "M1", "Wheelplan": "2-AXLE-RIGID BODY", "Revenue weight": "1740kg" } } ] }
{ "object": [ { "m": { "registration": "LB08VEX", "make": "MERCEDES-BENZ", "model": "A", "firstUsedDate": "2008.06.18", "fuelType": "Petrol", "primaryColour": "Silver", "vehicleId": "Ak2Fn-y7_A38GaM7Bfd1fw==", "registrationDate": "2008.06.18", "manufactureDate": "2008.06.18", "engineSize": "1498", "motTests": [ { "completedDate": "2019.06.13 13:55:21", "testResult": "PASSED", "expiryDate": "2020.06.12", "odometerValue": "63175", "odometerUnit": "mi", "motTestNumber": "447574153271", "odometerResultType": "READ", "rfrAndComments": [ ] }, { "completedDate": "2017.08.25 08:45:38", "testResult": "PASSED", "expiryDate": "2018.08.24", "odometerValue": "61709", "odometerUnit": "mi", "motTestNumber": "623253248603", "odometerResultType": "READ", "rfrAndComments": [ ] }, { "completedDate": "2016.08.25 13:05:06", "testResult": "PASSED", "expiryDate": "2017.08.24", "odometerValue": "58632", "odometerUnit": "mi", "motTestNumber": "989845747690", "odometerResultType": "READ", "rfrAndComments": [ ] }, { "completedDate": "2016.08.24 11:50:37", "testResult": "FAILED", "odometerValue": "58629", "odometerUnit": "mi", "motTestNumber": "179312693672", "odometerResultType": "READ", "rfrAndComments": [ { "text": "Offside Rear Seat belt locking mechanism does not secure or release (5.2.5a)", "type": "FAIL", "dangerous": false } ] }, { "completedDate": "2015.08.12 16:07:57", "testResult": "PASSED", "expiryDate": "2016.08.11", "odometerValue": "54745", "odometerUnit": "mi", "motTestNumber": "969524325201", "odometerResultType": "READ", "rfrAndComments": [ { "text": "Rear Parking brake lever has little reserve travel (3.1.6b)", "type": "ADVISORY", "dangerous": false }, { "text": "Under-trays fitted obscuring some underside components", "type": "USER ENTERED", "dangerous": false } ] }, { "completedDate": "2014.05.29 14:21:02", "testResult": "PASSED", "expiryDate": "2015.05.28", "odometerValue": "50622", "odometerUnit": "mi", "motTestNumber": "939669044129", "odometerResultType": "READ", "rfrAndComments": [ ] }, { "completedDate": "2012.06.25 13:19:13", "testResult": "PASSED", "expiryDate": "2013.06.24", "odometerValue": "49032", "odometerUnit": "mi", "motTestNumber": "285997972190", "odometerResultType": "READ", "rfrAndComments": [ { "text": "Nearside Inner Front suspension has slight movement at a wishbone pin or bush (2.5.A.1c)", "type": "ADVISORY", "dangerous": false }, { "text": "Offside Inner Front suspension has slight movement at a wishbone pin or bush (2.5.A.1c)", "type": "ADVISORY", "dangerous": false } ] }, { "completedDate": "2012.06.25 13:19:13", "testResult": "FAILED", "odometerValue": "49032", "odometerUnit": "mi", "motTestNumber": "706057872129", "odometerResultType": "READ", "rfrAndComments": [ { "text": "Offside Stop lamp not working (1.2.1b)", "type": "PRS", "dangerous": false }, { "text": "Nearside Inner Front suspension has slight movement at a wishbone pin or bush (2.5.A.1c)", "type": "ADVISORY", "dangerous": false }, { "text": "Offside Inner Front suspension has slight movement at a wishbone pin or bush (2.5.A.1c)", "type": "ADVISORY", "dangerous": false } ] }, { "completedDate": "2011.06.23 15:30:07", "testResult": "PASSED", "expiryDate": "2012.06.22", "odometerValue": "44020", "odometerUnit": "mi", "motTestNumber": "969564471146", "odometerResultType": "READ", "rfrAndComments": [ ] } ] } } ], "carMake": "assets/logos/MERCEDES-BENZ.png", "year": { "year": null } }
The API uses conventional HTTP response codes to indicate the success or failure of an API request.
| 200 - OK | Everything worked as expected. |
|---|---|
| 400 - Bad Request | The request was unacceptable (often due to missing a required parameter). |
| 403 - Forbidden | The parameters were valid but the request failed, or the request performed did not have permission. |
| 404 - Not Found | The requested resource doesn't exist. |
| 429 - Too Many Requests | The API request limit was exceeded (300 requests within a five-minute window). |
| 500, 502, 503, 504 - Server Errors | Something went wrong on our end. You may need to contact us if the error persists. |