CHECK LTD's Services API's


Introduction

We provide high-quality REST API for every our service. Response provided as JSON object.


Getting Started

You can start integrating data into your app or website as soon as you want. No additional registration or auth key required.


API Routes

Next section's provide examples and available routes for our projects

Quick Access 1. Companies 2. HouzeQ 3. Carcheck 4. Errors

Companies Routes

Companies List

GET /api/v1/company
curl https://checkltd.co.uk/api/v1/company
Example Response
{ "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" } ] }

Company Search

GET /api/v1/company?q={company_name | company_code}&items_per_page=2&start_index=0
curl https://checkltd.co.uk/api/v1/company?q=zync&items_per_page=2&start_index=0
Parameters
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.
Example Response

Company Full Info

GET /api/v1/company/{company_code}
curl https://checkltd.co.uk/api/v1/company/08209948
Example Response
{ "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" } }


Company Finance Info

GET /api/v1/company/{company_code}/finance
curl https://checkltd.co.uk/api/v1/company/00617987/finance
Example Response
{ "finance": { "code": "00617987", "cash_in_bank": 67019999999, "net_worth": 127660000000, "current_liabilities": -1430730000000, "employees": 268433 } }

HouzeQ Routes

Property Search

GET /api/v2/property?postcode={actual_postcode}&city={any_city}&street={any_street}&items_per_page=1&page_index=2
curl https://api.houzeq.co.uk/api/v2/property?postcode=lu2&city=luton&street=elmwood&items_per_page=10&page_index=0

All parameters for search are optional. You can perform request without any params specified.

Parameters
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.
Example Response

Property Info

GET /api/v2/geo?lat={latitude}&lng={longitute}
curl https://api.houzeq.co.uk/api/v2/geo?lat=51.636514&lng=-0.11666
Parameters
lng Longitute of searchable property in London. Required
lat Latitude of searchable property in London. Required
Example Response
{ "closest": [ { "city": "London", "street": "WINCHMORE HILL ROAD", "house_no": "178", "country": "UK", "postcode": "N21 1QP", "type": "S", "bed": 5, "price": 1053200, "distance": 0 } ] }

Carcheck Routes

Car Tax Information

GET /tax/{reg_number}
curl https://car.carcheck.app/tax/LB08VEX
Example Response
{ "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" } } ] }

Car MOT Info

GET /mot/{reg_number}
curl https://car.carcheck.app/mot/LB08VEX
Example Response
{ "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 } }

Errors

The API uses conventional HTTP response codes to indicate the success or failure of an API request.

HTTP Status Code Summary
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.