Telephone Business Class

Find out what you can do with our API...


API method to use: telephone_business_class

Skip to demo

Description

Searches companies house for UK businesses

Enter a place and/or a business class for businesses you would like to retrieve business data for then use the class codes to extract the data.

Mandatory Parameters


Name Description
api_key or javascript_key Use your API key if invoking server-side. If invoking from the browser via JavaScript, generate a JavaScript key using the javascript_key method.

Optional Parameters


Step One

Initially make a call with a business_class parameter in order to receive a business class list

Name Description
client You can optionally include an identifier for your final client or user. This is logged in your usage log and you will be able to view your usage statistics by client.
output Set to json for a JSON response; the default response is XML. Not applicable to the SOAP API.
callback When using JSON, specify a JSONP wrapper in which the JSON response is to be wrapped.
business_class The class of business which you would like to find telephone numbers for
place Enter a UK place, postcode, or postcode area. Do not specify this to do a national UK search.
max_records Zero based integer - Maximum amount of records to return.
records_per_page Specify the number of records to return on the current page. We offer page caching for this method - once your search is invoked, we store the pages on our server for 60 minutes; a subsequent request for a page of results from that search is displayed from the cache, at no charge to you. See result page caching.
page_num Zero based integer - current page number to return.

Step Two

When the user has selected one or more classes, enter the class_codes as a comma separated list in the class_codes parameter.

Using the above result:-

Name Description
client You can optionally include an identifier for your final client or user. This is logged in your usage log and you will be able to view your usage statistics by client.
output Set to json for a JSON response; the default response is XML. Not applicable to the SOAP API.
callback When using JSON, specify a JSONP wrapper in which the JSON response is to be wrapped.
class_codes Comma separated list of class codes from the above repsonse
place Enter a UK place, postcode, or postcode area. Do not specify this to do a national UK search.
max_records Zero based integer - Maximum amount of records to return.
records_per_page Specify the number of records to return on the current page. We offer page caching for this method - once your search is invoked, we store the pages on our server for 60 minutes; a subsequent request for a page of results from that search is displayed from the cache, at no charge to you. See result page caching.
page_num Zero based integer - current page number to return.

Error Codes


See the common error codes. There are no errors which are specific to this method.

Free Test Mode


When operating in the free test mode errors are returned if mandatory parameters are missing, or it returns a dummy data response, in an identical format to a real response.

Note that the mode is returned as test when the method is operating in the free test mode.

The free test mode for this method operates in the following manner:-

  • If the place parameter is set to leeds, a place_list is returned.
  • If the surname and place are both empty, a dummy street_list is returned.
  • a
  • If the surname is set (to anything) a dummy person_list is returned.

Example XML Response


Step One

<telephone_res>
<mode>normal</mode>
<status>ok</status>
<t2a_version_number>3.3.2.8b</t2a_version_number>
<business_class_list>
<business_class>
<class_name>Flowers Artificial</class_name>
<class_code>738</class_code>
</business_class>
<business_class>
<class_name>Florists</class_name>
<class_code>735</class_code>
</business_class>
</business_class_list>
</telephone_res>

Step Two

<telephone_res>
<mode>normal</mode>
<status>ok</status>
<error_code/>
<credit_used>2.5</credit_used>
<chargeable>true</chargeable>
<total_records>45</total_records>
<page_number>0</page_number>
<t2a_version_number>3.3.2.8b</t2a_version_number>
<business_list>
<business>
<share_id>
jktxe8XeedMsv1sVH8f8td5o6VRNBArkfbKs46ISxcdl-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzh9DxBFbyV_Dv8UDkDb42I_W23oQCCX4M8krEclkQ4J9tdiUX9d6kIfPIam5jAPguFtrz9SyWH53AMeAsYVluq7nd5FYBJlP2UurW2dX0VMfYctzV6ZTZ4S5iYxrgRehIflZzUlkXtfWI0xJQfl-8gAVX5d53Su2PKNnBEI2v-_O3zEldpN-SXhLifbSuHna6QsL9ItinVKn5vyWn_NuyXl9s5d6tfDUbQuDJhe5OuXHGbIgiW_MvyjVI0-LcXPbHNY6EqUwzSnuHStK81eBv3dO-hcwJCt2VBNvnVA48lzw6JpAm60OtnDZQWVdvavm0HkH2Aoi2Vze7Vdrj24ktJGfbdtGBq_PtWqrj84eg01l9Alth2RWKNz9SKF9D3oxMwhvtX31VljUt1tD7OVhfO023WUYo8ruqe_SoUeJzSaGjy7BL3YsFlPC_l
</share_id>
<line_1>York Cemetery, Cemetery Road</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place/>
<town>York</town>
<postcode>YO10 5AJ</postcode>
<addr_single_line>
York Cemetery, Cemetery Road, North Yorkshire, York, YO10 5AJ
</addr_single_line>
<data_src/>
<name>Acorns Flowers</name>
<telephone_number>(01904) 659944</telephone_number>
<web/>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
<business>
<share_id>
q8b5y3GKkFH3KOlwb3dJtIuEdgCwaYMlpdf-B_3m_vdg-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhri1Pa_Cp16ugq6M_MWgUzHdTRVONTMwrP3ed4921Q-t3-ia4g3P2x58Vt-ToO7HytfPI2QoUqI39ySnIYkIJuBtdcMLNR95tufKp3b5qyadf__ygoATVGvrFcTc2RCXIFL_6qEMREZ05Iji62LQo0D08zBMcZVplMU8nrVjBVMfXoMdaCdOQskonCFQB0Jb37ip0twzDvk_wXmxEjcBbD77PJ6_tRxn-xXZt46K_XVOhYM73t3wh-RNqygfeP7JxUiogACdOjRQMWSoWtxDXlsfNCEu__g1JkfohoN25b6UC2W9UlBzlvfxNIO9go6hqZq8Ko77pz-O_718rLECWZ7A4q3E2VzzJRGBo3zA1JHbeseiVRAxEzV_JjsSl-bVaH6RZwIzOU0zd2KLIQXv7J7HPecENED-qz4q5v6MdYcrLSGwRJ2nLgzt_TOzAqOc2OO3b_WShEJh7zXugwgjkS6bbDu8ZHIo03I_L37B-Xz9LjRta5-Ey2rtXd3svzNxQCcCM-eBfsjDr7xzW
</share_id>
<line_1>1 Far Northings Cottage, Far North Ings</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Terrington</place>
<town>York</town>
<postcode>YO60 6PQ</postcode>
<addr_single_line>
1 Far Northings Cottage, Far North Ings, North Yorkshire, Terrington, York, YO60 6PQ
</addr_single_line>
<data_src/>
<name>Alison Massingham Flowers</name>
<telephone_number>(01347) 878345</telephone_number>
<web>www.alisonmassingham.co.uk</web>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
<business>
<share_id>
LKh9Hjgvf4C_-KHShkVZdwfjg8eXVWxzy-Xdz35lS_dA-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhri1Pa_Cp16ugq6M_MWgUzHdTRVONTMwrP3ed4921Q-t3RWdQnamOmlx3L-9TOUuit5IOUbHKCmE4dq4h7erU6kzVwiIKThRxmw1Ql_SwL590_NdKvnmguIrGNs1hDzCTBmtdRosrjw2EQAh0kBhEZRk4dhHikF0u9IIj6ENqUVNUWszoGtHynXMPebXTH_VJjLCrd-WuHgRSMJmfTOfhyYLjwUz6cbVD7ACShRzWTc3_hinA_MZx2AX4jtg-dj76cweXS4_gn9OOX69RG1ZVkdF5LznTdhhCO1-UulN2IVX6G0XLw3tbCqSapIJIsKq2soD3sWWjzwoTfyOz9I56jAYIq2XBuZtAZa2DInvFMTtzW45ea1hGtmo7leIMVBLb9u7ZfttowT_kym3HLD6i2Yh_wsCbkV3ktdFkBc7JYKme2xHCovzYHC_6JRJbkvtJDvcTbj7AeNXud1Gbr9Zno83dxiXDKJmsr3_05GBEMlEt6B6mxTwOtnGktGsNtxPJjwN-N2hTmyK8TPtw
</share_id>
<line_1>Cavenagh House, The Square</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Sheriff Hutton</place>
<town>York</town>
<postcode>YO60 6QX</postcode>
<addr_single_line>
Cavenagh House, The Square, North Yorkshire, Sheriff Hutton, York, YO60 6QX
</addr_single_line>
<data_src/>
<name>Alison Massingham Flowers</name>
<telephone_number>(01347) 878144</telephone_number>
<web>www.alisonmassingham.co.uk</web>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
<business>
<share_id>
zmUtizZr3NkHwgkJJKDntDB8TtveIVbWeUxDbFD0nGtK-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhHXwrvdbj1FZJvdmvR7WOdwFJiRTynetQBwqa_yvdsxzz_vXh_Rc3xJlxUNV0gFlQzFdk9vqDRY5dWnFEOVy-Vh_sm4VpnAwfJItyvoqloyKb_pfbacugG_qZymOw2f-YvqtBOepWkOAWXrZ1oux59HEf_sn6HLwev25gVVUzP2qwapdqiml1ZtnMxbuP-oIKcBn5dNjR8MIrN0sktp4XpTsK9NdzjI8oyPatCsIWTEiIyAIFtBRhEDW2uT-x0pyx5228ket0zPbYuqnCCPZKzUcjBhHptH9B0i2sZJXDdRq1upDaIizNeLpxwdiVOsM9YbhdZxNrtqzSs446oJRQvkxrp6gxZ2trcdcOUEIl74IlhFsRHCXOzxaEa8Bjn3t-DG35YuoktAdL56naQ8_tVSZ4Ox5i2SjVdoBTuMP7y4HxxM4srNmyfWt0DFOweeCMhxp9zUPhqF64t7sV01pKZAr9eyIo7sQhIVz7
</share_id>
<line_1>1-2 Chapmans Yard, Marston Road</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Tockwith</place>
<town>York</town>
<postcode>YO26 7PR</postcode>
<addr_single_line>
1-2 Chapmans Yard, Marston Road, North Yorkshire, Tockwith, York, YO26 7PR
</addr_single_line>
<data_src/>
<name>Beautiful Flowers</name>
<telephone_number>(01423) 358471</telephone_number>
<web>www.angiewalkerbeautifulflowers.co.uk</web>
<fax_number/>
<classification>
Retail sale of flowers, plants, seeds, fertilisers, pet animals and pet food in specialised stores
</classification>
</business>
<business>
<share_id>
nrOT5H5-5dC1HWXgZuN9tVj9a0zWGvx8pm3WFdtWASzn-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhc26Y622jaQ3U82qpelPVdXEnmnH2FNEJJWAHKcON2ItsUYlMOa3mqQiVFHksdfRMd-6bMpOzneMgNNra8x8UdlzGpz-2zUP-VMmw_GUTyXI0t2T3VagfBLoA_Z0moKPFtFdycfuugVayuz_CeO7p5fBr_ObaymOqs4zlUXn2pfYZ_e_sGdSCm3-mpQOfqgDUmSsDdPByk0S8hw8XHp8OnQoTWEtCOEBmrj5jr2UbbhNpet7h_uCEPeJnjn79AcWr0RXJLFt4iFYLpmGk-oAklvJ_jXux_rZ1ldANt9oSygW8j3PZERddwVpUF7xQlGJK-BaUzu6m_xSdEXtZE33yDiWBJDkXw8tghdEoMsrBeVJQD67sAylJ_eeLpKAFq2N1LYkTZ5qTelz4O0T6DJmMsWcArSZt2Cwndo9KxBSPOKR_6oUhGFpEe_tK
</share_id>
<line_1>4 West End</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Kirkbymoorside</place>
<town>York</town>
<postcode>YO62 6AF</postcode>
<addr_single_line>
4 West End, North Yorkshire, Kirkbymoorside, York, YO62 6AF
</addr_single_line>
<data_src/>
<name>Becci's Blooms</name>
<telephone_number>(01751) 798010</telephone_number>
<web/>
<fax_number/>
<classification>
Retail sale of flowers, plants, seeds, fertilisers, pet animals and pet food in specialised stores
</classification>
</business>
<business>
<share_id>
djk4FIM2IhzXOTZLiZAuddemmUWcmS5WUHFkWm4cnNd3-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhSLLYKDS4lK8rNq4GaT1WzslA2KwlQZ7_JpnATw1tXadJlh8XXFUXoUDiTyPaWqUntyeaFyWc6Y2vNPtcukWa8jdrkaLbFmFxMHnyLpIpV-kw_F-1rd_22opLpV2KVZpNrc_Iww0Iu-TxwW4kNWgIXNLW_tY1W5yV01XVgscCYCc03FdpbzSE6VWEBmbw2ZKirs4ot37x1Ed8IZAoFbwCYiYmk8tx9R2XZDBRb-b5R3Edi5tQzHoz9Ip9gGT0j3wRC4D9uz_0wpuRD06Fr_TLkXxAZJn5zKeWGOO9xKLhqslr-8MlnkdhEHWGZ4Wj4hAPOMNbBZ3rzBOEzeKu7071OklNaBDJVv_XmWp3g_l_mn24ddSFWP3_zOZ3T38VeLYgiZT8aEo8FQ_NustlWMycdgi2QT_eVATd_KeqWtLMhb2sZpm1I5ROvVzNTWH_e_aaOSVV_sMdfb6y_kdjKgO0TuMUWl7zve7h0Wd4
</share_id>
<line_1>28 Acaster Lane</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Bishopthorpe</place>
<town>York</town>
<postcode>YO23 2SJ</postcode>
<addr_single_line>
28 Acaster Lane, North Yorkshire, Bishopthorpe, York, YO23 2SJ
</addr_single_line>
<data_src/>
<name>Bloom Service</name>
<telephone_number>(01904) 778900</telephone_number>
<web>www.bloom-service.co.uk</web>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
<business>
<share_id>
ogVputb-faaOjrrt8rUzdUtAqKANnNhvshst33_EbD_k-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhVDqhFjdV2vrI6P9U7JCrzi6NDD_zm_tLj0JoNvIEo6zuK__oLBMkTLJU9MO8qG04_f2x_vKvDXLhMtXYgi087PzOqEMREZ05Iji62LQo0D08zBMcZVplMU8nrVjBVMfXoMdamJ5t7xRupS6sBuDzXCpHtMJJz1wRmguZ-IYMTS9YmRtprjyBLi7n30PesX4UyL0qtqfzvv3VYX0R9B4aaSPDrKzVHPbmYVhN5aBXsTtpsW0X_50RSzAc8nxHJWIpCXusVd_LMMv5UKdqWL9pmB7Qq4IQ_4bn81v-CDjWEgxCnGYQm_thLNtq3ntNJSGDonuewb3i_9_30944yR5oEF2zkeir0ktXF3UwfPznmomRyNa6ZAciz178EcLqga0h28Vq7Rdp5wztQ13qFr7ZCV8pmZsgJJ2odFc0Al2pPr_roXNYIG6Sps_r7jjpj4aOsFg7T2Giq85p_TIfm1lxqfvPtUwSQ986rWzw
</share_id>
<line_1>42 High Street</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Boroughbridge</place>
<town>York</town>
<postcode>YO51 9AW</postcode>
<addr_single_line>
42 High Street, North Yorkshire, Boroughbridge, York, YO51 9AW
</addr_single_line>
<data_src/>
<name>Bloomerang Flowers</name>
<telephone_number>(01423) 324863</telephone_number>
<web>www.bloomerang-flowers.co.uk</web>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
<business>
<share_id>
sZGz6XgRNdCO7J_ysmxqtJwLbYGGv0Z4_CSkn7WxMi_R31UFFA0N2JKPoysFXD5zz6rTB_MOkuezk3n4qSia2Qd_L6TyQZAUS3Wqzgh6DR5T_ii4zRlAtZTSaOFgwxHHaQdgfLsuJh3R9gljBkD02CbrzU4UlMOOX_5GsYepfAcpR5_ZSvL1QkGLv0LYDdlGNbZidoo4mlzBiJxbWZQp0bsQBftNjvHn8uhgkQnInuvYM0srtxvpzlAyjTdBRXpGiMGvp7_qSXkbIjcHvyKw700cSvf2dFC5HGPV6oogA7obcppHinzbUEVeJOZ56SdHdD_rw5AldC-pO4qKhquEl-Ud8KCWJKzcvsOih27ZsQxlx5JBA3Rwd7voXpl-oXcLuH5rQaDm28z1b8q-4LuKsMyKSWh9uPuetB5ak7hVpvlr4Do9qxbTgOtqAmoLaF5mf8MrB_2WKw_GzxCll5zL3rw0fJZlakByMQtir-iMjOyRdG_b5m754JBhdk2uohxwj8W-_YTXHPOUbWdkpOmo7P8xnhjjHf4-iRqjddaAPxbxrxTEru7onjw4iNz4
</share_id>
<line_1>62 Market Street</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Pocklington</place>
<town>York</town>
<postcode>YO42 2AF</postcode>
<addr_single_line>
62 Market Street, North Yorkshire, Pocklington, York, YO42 2AF
</addr_single_line>
<data_src/>
<name>Blooming Occasions Florist</name>
<telephone_number>(01759) 303672</telephone_number>
<web>www.bloomingoccasions.co.uk</web>
<fax_number/>
<classification>
Retail sale of flowers, plants, seeds, fertilisers, pet animals and pet food in specialised stores
</classification>
</business>
<business>
<share_id>
MjwLXpodnmWmW4k2YGUCzm54s9SdpCySO-sFlDSn5CtE-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzhGDgAyuY5aGGWcfddyeBgd5JPDiioq4tt9PcUeX-Uhz_B4YgbEmWkl1JVC5QrIkjCt4SbmdOnbznBfpcUvCzziN_0wvFRTax1sLo2BSvekQ1sdpdxgYJeI0kPjGKCvd6jqxtkeza2xq9NRTawgFJN6CLRtQ8Pac4Y1zZYpqmX8PnwrzzyMlXnfV9oR98pOkVkdc54tAz3DVt9GUFbyeCRyq-FbXdWGyxRxlKr4cQyKvkL8xQp_NWBKSqpRXcGBj2JBfpywkdX8pS6Fhx4rn-uxU_2k_Y-zGU2TRdmpTB10uAGygABHedbmnNFu00MiaDlw5Jcx6J5zrNCS7ZOb_IKWoepPmf-T8dI8KSgebCuRD6yaXAx1dIMtsDJopsIVC5MLwgXK-ejGa_kdDpoq-n2A3RPR_yhFQZ9_1VkHy2auVDtjQMNnxyVcb_DmWAwWdtVOqNDMDDPFL2Z_ABmOntC0IA6K37cEW7yVQtvOzPpc9yoi9BMqG1gL4UJtZYpIQrf6DAYt_y3qMrV4gtH
</share_id>
<line_1>
Unit 2D Hampden Road, Pocklington Industrial Estate
</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Pocklington</place>
<town>York</town>
<postcode>YO42 1NR</postcode>
<addr_single_line>
Unit 2D Hampden Road, Pocklington Industrial Estate, North Yorkshire, Pocklington, York, YO42 1NR
</addr_single_line>
<data_src/>
<name>Blossom Bouquets</name>
<telephone_number>(0113) 379 1892</telephone_number>
<web>www.blossombouquets.co.uk</web>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
<business>
<share_id>
uqyTPaJ0gOkWffLhFhSezP6dSuYsG6lC4la3i9E-iitU-FaWzRjfbVo86ctYrxLQ_pnRw_LwFnMQuySEDTnarqzh3VhjOMzAFtU75SHVBYG8tAgUi7tSr2dQzby9f964Rj_KoryAvm5-eB9Vqfu5fP2M_-vvBZnT7zUfiUBy0TbJx7tA8V09eJGXdBHi67v6l-zLtlS5uc91WC25DtQEKkldW_dfkzl9-mUHTrMWhSVtmalP_S9dmEVya5KFOppaLtR5EG_NhXfFxRAH0oHN2eaXHtGvdZyfDzZIrWgWAZ99f6oXCFzHDV341-CSWdW2YAWSvwIJtcsp0mGZLqKFr6V6ZK467qd617lc6JqdHH4FhDgedgGu_TdHl1aNQ5nB9Lwq-TNlcf_Xr-QBiegORt9RzO8AULWOtucPA2adduf6qlYutxlhofzuHncw7KxjnTSr_fuoE_o4dPIqsSoE3ypSAQD82df8-5tS-vSsBhh-QK9BQ35aBzl_zoKowWCpclZPbegXma8XE6_vN6_Pmf0P9g4Ar27t4XDGtVENw79Z6YmP0XSObYhiLZ_-
</share_id>
<line_1>12 Crown Square</line_1>
<line_2>North Yorkshire</line_2>
<line_3/>
<place>Kirkbymoorside</place>
<town>York</town>
<postcode>YO62 6AY</postcode>
<addr_single_line>
12 Crown Square, North Yorkshire, Kirkbymoorside, York, YO62 6AY
</addr_single_line>
<data_src/>
<name>Busy Liz's Floral Design</name>
<telephone_number>(01751) 430009</telephone_number>
<web>www.busylizs.co.uk</web>
<fax_number/>
<classification>
Other retail sale of new goods in specialised stores (other than by opticians or commercial art galleries), n.e.c
</classification>
</business>
</business_list>
</telephone_res>