Give Food

API

Beta

Get access to our data over HTTPS in JSON.

  • Do good with the data
  • Try not to make requests more than a few times a second
  • If you display a food bank and their need also use their URL to link to them
  • Credit us with a link to our homepage if you republish
  • Don't cache too long, all this is updated at least hourly

Our API and data has been used by The Times, Reach PLC, Cuvva, Munch & Trussell Trust.

Do not hesitate to contact us at mail@givefood.org.uk with any questions.

All Food Banks

Returns a list of all food bank organisations known to us. This is also available as a CSV.

https://www.givefood.org.uk/api/1/foodbanks/
Description Example
name Name of the food bank Bristol East
slug URL-safe slug of the name of the food bank bristol-east
address Address of the food bank 32 Stapleton Road
Easton
Bristol
postcode Postcode of the food bank BS5 0QY
country Country (or British crown dependency) of the food bank England
latt_long Lattitude and longitude of the food bank 51.4597049,-2.577905
closed If the food bank has closed false
phone Phone number of the food bank 07584 625082
email Email address of the food bank ebfoodbank@crisis-centre.org.uk
url URL of the homepage of the food bank https://eastbristol.foodbank.org.uk
shopping_list_url URL of the shopping list for the food bank https://eastbristol.foodbank.org.uk/give-help/donate-food/
charity_number Identifer of the charity the food bank runs under in it's country 298528
charity_register_url URL of the details of the food bank's charity at the charity registrar https://beta.charitycommission.gov.uk/charity-details/?regId=298528
network Name of the network the food banks is a member of Trussell Trust
parliamentary_constituency Name of the parliamentary constituency in which the food bank is in Bristol West
mp_party Name of the political party of the MP representing the parliamentary constituency in which the food bank is in Labour
mp Name of the MP representing the parliamentary constituency in which the food bank is in Thangam Debbonaire
district Name of the district in the food bank is in Bristol, City of
ward Name of the ward in the food bank is in Lawrence Hill

When given a place returns list of ten food banks nearby that are not closed. Querying by lattlong is much quicker than address, so use that if possible.

https://www.givefood.org.uk/api/1/foodbanks/search/?lattlong=53.42,-2.55
https://www.givefood.org.uk/api/1/foodbanks/search/?address=66 The Headrow Leeds LS1 8EQ

Returns all of the fields above, plus...

Description Example
distance_mi Distance in miles from the place submitted 7.72
number_needs Number of line items requested by the food bank 4
needs Linebreak separated list of line items requested by the food bank, or "Nothing" or "Unknown" Coffee
Long life Juice
Cooking sauce
Tinned custard
need_id String that uniquely identifies a need requested 57e15d18
updated Date and time the need was updated 2020-02-17 09:04:44.603292+00:00
updated_text Human readable version of date and time the need was updated 1 week, 4 days

Food Bank

When given the food bank slug returns the details for an individual food bank organisation.

https://www.givefood.org.uk/api/1/foodbank/black-country/

Returns all of the fields above, plus...

Description Example
locations List of locations we know of for this organisation's outlets
{
  latt_long: "51.4324167,-0.1034595",
  postcode: "SE27 0HS",
  name: "Norwood",
  address: "St Luke's Church Knights Hill West Norwood London",
  phone: "07722 121108",
}
parliamentary_constituency Name of the parliamentary constituency in which the food bank is in Bristol West
mp_party Name of the political party of the MP representing the parliamentary constituency in which the food bank is in Labour
mp Name of the MP representing the parliamentary constituency in which the food bank is in Thangam Debbonaire
district Name of the district in the food bank is in Bristol, City of
ward Name of the ward in the food bank is in Lawrence Hill