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/gb/facilities?query=farm is accessible via the API at transparentfarms.org/gb/facilities.json?query=farm or transparentfarms.org/gb/facilities.csv?query=farm.

Need help accessing the data? Contact us for assistance.

Facilities

Facilities Index

List all facilities.

GET
transparentfarms.org/gb/facilities.json

Parameters

classifications[]
Optional
Allowed values of Farm DairyFarm FinishingUnit 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 Wales Scotland Northern Ireland .
county[]
Optional
Allowed values of Berkshire Buckinghamshire West Northamptonshire Cheshire West and Chester Cheshire East Wrexham Principal Area Flintshire England Warrington Cornwall Devon Derbyshire Cumbria Somerset County Durham Perth and Kinross Aberdeenshire Dorset Aberdeen City Na h-Eileanan an Iar Moray Highland Council Fife Angus Council Orkney Dumfries and Galloway Midlothian Gloucestershire Stirling North Lanarkshire Renfrewshire South Ayrshire Council North Ayrshire Council South Lanarkshire Argyll and Bute Council Scottish Borders Herefordshire Worcestershire Glasgow City Shetland Islands West Yorkshire East Riding of Yorkshire North Lincolnshire North Yorkshire Tyne and Wear Leicestershire Greater Manchester South Yorkshire York Nottinghamshire Staffordshire Hampshire Oxfordshire Telford and Wrekin Norfolk Essex Kent Lancashire West Midlands Suffolk Lincolnshire Warwickshire North Northamptonshire Northamptonshire Surrey South Gloucestershire North Somerset Bath and North East Somerset Shropshire Powys Merseyside Stoke-on-Trent Wiltshire Leicester Central Bedfordshire Greater London Cambridgeshire Hertfordshire Bedford Carmarthenshire Ceredigion Pembrokeshire Monmouthshire East Sussex West Sussex Isle of Anglesey Gwynedd Bridgend County Borough Swansea Ynys Môn Conwy Denbighshire Torfaen Principal Area Merthyr Tydfil County Borough Wales Newry, Mourne and Down Mid Ulster Derry and Strabane Armagh City, Banbridge and Craigavon Fermanagh and Omagh Mid and East Antrim Causeway Coast and Glens Antrim and Newtownabbey Blackburn with Darwen Conwy Principal Area Swindon Redcar and Cleveland Newport Rutland Northumberland Stockton-on-Tees Darlington Hartlepool Isle of Wight Sir Ceredigion Sir Gaerfyrddin Caerphilly County Borough Sir Ddinbych Sir Benfro Borough of Halton Cardiff Vale of Glamorgan Derby Neath Port Talbot Principle Area St Sampson Kingston upon Hull Rhondda Cynon Taff Braddan Wrecsam Isles of Scilly Middlesbrough Milton Keynes Lisburn and Castlereagh Ards and North Down Northern Ireland Pen-y-bont ar Ogwr County Galway North East Lincolnshire Peterborough Bristol City .
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/gb/facilities/[slug].json

Path Parameters

slug