Data Access and API

Introduction

Our API is free to use and does not require authentication. In general endpoints follow the same structure as URLs on the site with the addition of .json or .csv appended to them. For example transparentfarms.org.uk/facilities?query=farm is accessible via the API at transparentfarms.org.uk/facilities.json?query=farm or transparentfarms.org.uk/facilities.csv?query=farm.

Need help accessing the data? Contact us for assistance.

Facilities

Facilities Index

List all facilities.

GET
transparentfarms.org.uk/facilities.json

Parameters

classifications[]
Optional
Allowed values of Farm DairyFarm IntensivePigFarm IntensivePoultryFarm IntensiveSowPigFarm Slaughterhouse CowSlaughterhouse GoatSlaughterhouse HorseSlaughterhouse LargeBirdSlaughterhouse OtherMammalSlaughterhouse PigSlaughterhouse PoultrySlaughterhouse SheepAndLambSlaughterhouse WildBirdSlaughterhouse WildRabbitSlaughterhouse .

Including a parent classification (eg Slaughterhouse) will include all facilities that match child classifications.
country[]
Optional
Allowed values of England Northern Ireland Scotland Wales .
county[]
Optional
Allowed values of Aberdeen City Aberdeenshire Angus Council Antrim and Newtownabbey Ards and North Down Argyll and Bute Council Armagh City, Banbridge and Craigavon Bath and North East Somerset Bedford Berkshire Blackburn with Darwen Borough of Halton Braddan Bridgend County Borough Bristol City Buckinghamshire Caerphilly County Borough Cambridgeshire Cardiff Carmarthenshire Causeway Coast and Glens Central Bedfordshire Ceredigion Cheshire East Cheshire West and Chester Conwy Conwy Principal Area Cornwall County Durham County Galway Cumbria Darlington Denbighshire Derby Derbyshire Derry and Strabane Devon Dorset Dumfries and Galloway East Riding of Yorkshire East Sussex England Essex Fermanagh and Omagh Fife Flintshire Glasgow City Gloucestershire Greater London Greater Manchester Gwynedd Hampshire Hartlepool Herefordshire Hertfordshire Highland Council Isle of Anglesey Isle of Wight Isles of Scilly Kent Kingston upon Hull Lancashire Leicester Leicestershire Lincolnshire Lisburn and Castlereagh Merseyside Merthyr Tydfil County Borough Mid and East Antrim Mid Ulster Middlesbrough Midlothian Milton Keynes Monmouthshire Moray Na h-Eileanan an Iar Neath Port Talbot Principle Area Newport Newry, Mourne and Down Norfolk North Ayrshire Council North East Lincolnshire North Lanarkshire North Lincolnshire North Somerset North Yorkshire Northamptonshire Northern Ireland Northumberland Nottinghamshire Orkney Oxfordshire Pembrokeshire Pen-y-bont ar Ogwr Perth and Kinross Peterborough Powys Redcar and Cleveland Renfrewshire Rhondda Cynon Taff Rutland Scottish Borders Shetland Islands Shropshire Sir Benfro Sir Ceredigion Sir Ddinbych Sir Gaerfyrddin Somerset South Ayrshire Council South Gloucestershire South Lanarkshire South Yorkshire St Sampson Staffordshire Stirling Stockton-on-Tees Stoke-on-Trent Suffolk Surrey Swansea Swindon Telford and Wrekin Torfaen Principal Area Tyne and Wear Vale of Glamorgan Wales Warrington Warwickshire West Midlands West Sussex West Yorkshire Wiltshire Worcestershire Wrecsam Wrexham Principal Area Ynys Môn York .
query
Optional
Filter the facility name, operator and address by a given search term.
operator
Optional
Filter the facility operator by a given search term.
operational
Optional
Allowed values of 0 (facilities that are not operational) or 1 (facilities that are operational).
limit
Optional
The number of results per page (defaults to 30).

Facilities Show

List a single facility.

GET
transparentfarms.org.uk/facilities/[slug].json

Path Parameters

slug

Statistics

Statistics Index

List all statistics.

GET
transparentfarms.org.uk/statistics.json

Statistics Show

List a single statistic.

GET
transparentfarms.org.uk/statistics/[statistic-slug]/[dimension-slug].json

Path Parameters

statistic-slug
dimension-slug