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", "care_of": null, "address_line1": "METROHOUSE 57 PEPPER ROAD", "address_line2": "HUNSLET", "post_town": "LEEDS", "country": null, "post_code": "LS10 2RU", "company_category": "Private Limited Company", "company_status": "Active", "country_of_origin": "United Kingdom", "dissolution_date": null, "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. |
{ "companies": [ { "code": "08119994", "name": "CLOUDZYNC LIMITED", "care_of": null, "address_line1": "5TH FLOOR", "address_line2": "9 DEVONSHIRE SQUARE", "post_town": "LONDON", "country": "ENGLAND", "post_code": "EC2M 4YF", "company_category": "Private Limited Company", "company_status": "Active", "country_of_origin": "United Kingdom", "dissolution_date": null, "incorporation_date": "2012-06-26 00:00:00", "account_category": "FULL", "sic": "62012 - Business and domestic software development", "last_update": "2020-01-04 19:53:39" }, { "code": "08678190", "name": "PRODUCTION ZYNC LTD", "care_of": null, "address_line1": "THE OLD BARN", "address_line2": "OFF WOOD STREET", "post_town": "SWANLEY VILLAGE", "country": "ENGLAND", "post_code": "BR8 7PA", "company_category": "Private Limited Company", "company_status": "Active", "country_of_origin": "United Kingdom", "dissolution_date": null, "incorporation_date": "2013-09-05 00:00:00", "account_category": "TOTAL EXEMPTION FULL", "sic": "93290 - Other amusement and recreation activities n.e.c.", "last_update": "2020-01-04 19:53:39" } ] }
{ "company": { "code": "00617987", "name": "HSBC HOLDINGS PLC", "care_of": null, "POBox": null, "address_line1": "8 CANADA SQUARE", "address_line2": null, "post_town": "LONDON", "county": null, "country": null, "post_code": "E14 5HQ", "company_category": "Public Limited Company", "company_status": "Active", "country_of_origin": "United Kingdom", "dissolution_date": null, "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", "sic_code2": null, "sic_code3": null, "sic_code4": null, "num_gen_partners": 0, "num_lim_partners": 0, "previous_condate1": null, "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", "previous_company_name5": null, "previous_condate6": null, "previous_company_name6": null, "previous_condate7": null, "previous_company_name7": null, "previous_condate8": null, "previous_company_name8": null, "previous_condate9": null, "previous_company_name9": null, "previous_condate10": null, "previous_company_name10": null, "post_code_f": "E", "post_code_s": "E14", "visible": true, "coordinates": "51.505505@-0.0179999", "last_update": "2020-01-04 19:53:39" } }
{ "finance": { "code": "00617987", "cash_in_bank": 67019999999, "net_worth": 127660000000, "current_liabilities": -1430730000000, "employees": 268433 } }
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. |