Telephone Business Class
Find out what you can do with our API...
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, aplace_list
is returned. This is to cater for a scenario where an ambiguous place name is entered (there are several places called Leeds in the UK).
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>