Give Food

API Docs

Beta

foodbanks
List of all the food banks we know of
foodbank
Food bank including needs and locations
foodbanks/search
Find food banks closest to an inputted location
locations
List of all the food bank loctions we know of
locations/search
Find food bank locations closest to an inputted location
needs
Latest needs published countrywide
need
Need requested by a food bank
constituency
Parliamentary constituency

foodbanks

Returns a list of all known food banks, with limited information about them. This is a large request (returns around 1MB uncompressed) and can take us a couple of seconds to produce, to please use sparingly.

Field Type Example Description
address Multiline String Sidmouth Youth Centre
Manstone Lane
Sidmouth
EX10 9TS
alt_name String Carerdydd Alternative name, for example in Welsh
closed Boolean false
country String England Country, or Crown dependency, that the food bank's main location is in
charity
registration_id String 1188192 Charity number of the registered charity that the food bank operates under
register_url URL https://beta.charitycommission.gov.uk/charity-details/?regId=1151274 URL of the charity entry with the local registrar
created String 2019-07-01T13:42:01.565Z Date and time of when we first found the food bank
email Email Address info@sidvalleyfoodbank.org.uk
lat_lng String 51.4630738,-0.1207938 Comma separated latitude and longitude
name String Sid Valley Name of the food bank
network String IFAN Name of the food bank network the food bank is in, or "Independent"
phone String 07413858335 Phone number
politics
parliamentary_constituency String Vauxhall Name of the parliamentary constituency the food bank's main location is in
mp String Florence Eshalomi Name of the member of parliament who represents parliamentary constituency that the food bank's main location is in
mp_party String Labour Political party of the member of parliament who represents parliamentary constituency that the food bank's main location is in
ward String Streatham Hill Name of the ward the food bank's main location is in
district String Lambeth Name of the district the food bank's main location is in
urls
html URL https://www.givefood.org.uk/needs/in/constituency/vauxhall/ HTML URL of the parliamentary constituency
self URL https://www.givefood.org.uk/api/2/constituency/vauxhall/ API URL of the parliamentary constituency
postcode String GU16 7HF
secondary_phone String 07413858335 Secondary phone number
slug String hull Slugified name of the food bank
urls
homepage URL https://norwoodbrixton.foodbank.org.uk/ Homepage of the food bank
html URL https://www.givefood.org.uk/needs/at/norwoodbrixton/ HTML URL of the food bank
self URL https://www.givefood.org.uk/api/2/foodbank/norwoodbrixton/ API URL of the food bank
shopping_list URL https://norwoodbrixton.foodbank.org.uk/give-help/donate-food/ URL of the shopping list where we find what a food bank requires
format

foodbank

Returns the details of a single food bank, including what is requesting to be donated and nearby food banks.

Field Type Example Description
address Multiline String Sidmouth Youth Centre
Manstone Lane
Sidmouth
EX10 9TS
alt_name String Carerdydd Alternative name, for example in Welsh
closed Boolean false
country String England Country, or Crown dependency, that the food bank's main location is in
charity
registration_id String 1188192 Charity number of the registered charity that the food bank operates under
register_url URL https://beta.charitycommission.gov.uk/charity-details/?regId=1151274 URL of the charity entry with the local registrar
created String 2019-07-01T13:42:01.565Z Date and time of when we first found the food bank
email Email Address info@sidvalleyfoodbank.org.uk
lat_lng String 51.4630738,-0.1207938 Comma separated latitude and longitude
name String Sid Valley Name of the food bank
nearby_foodbanks List Some fields of the food banks nearby
network String IFAN Name of the food bank network the food bank is in, or "Independent"
phone String 07413858335 Phone number
politics
parliamentary_constituency String Vauxhall Name of the parliamentary constituency the food bank's main location is in
mp String Florence Eshalomi Name of the member of parliament who represents parliamentary constituency that the food bank's main location is in
mp_party String Labour Political party of the member of parliament who represents parliamentary constituency that the food bank's main location is in
ward String Streatham Hill Name of the ward the food bank's main location is in
district String Lambeth Name of the district the food bank's main location is in
urls
html URL https://www.givefood.org.uk/needs/in/constituency/vauxhall/ HTML URL of the parliamentary constituency
self URL https://www.givefood.org.uk/api/2/constituency/vauxhall/ API URL of the parliamentary constituency
postcode String GU16 7HF
secondary_phone String 07413858335 Secondary phone number
slug String hull Slugified name of the food bank
urls
homepage URL https://norwoodbrixton.foodbank.org.uk/ Homepage of the food bank
html URL https://www.givefood.org.uk/needs/at/norwoodbrixton/ HTML URL of the food bank
self URL https://www.givefood.org.uk/api/2/foodbank/norwoodbrixton/ API URL of the food bank
shopping_list URL https://norwoodbrixton.foodbank.org.uk/give-help/donate-food/ URL of the shopping list where we find what a food bank requires
foodbank
format

locations

Returns a list of all known food bank locations, with limited information about them. This is a large request (returns around 1MB uncompressed) and can take us a couple of seconds to produce, to please use sparingly.

Field Type Example Description
address Multiline String Sidmouth Youth Centre
Manstone Lane
Sidmouth
EX10 9TS
email Email Address info@sidvalleyfoodbank.org.uk
foodbank
name String Sid Valley
network String Independent
slug String sid-valley
urls
html URL https://www.givefood.org.uk/needs/in/sid-valley/ HTML URL of the food bank
self URL https://www.givefood.org.uk/api/2/foodbank/sid-valley/ API URL of the food bank
lat_lng String 51.4630738,-0.1207938 Comma separated latitude and longitude
name String Sid Valley Name of the food bank location
phone String 07413858335 Phone number
politics
parliamentary_constituency String Vauxhall Name of the parliamentary constituency the food bank's main location is in
mp String Florence Eshalomi Name of the member of parliament who represents parliamentary constituency that the food bank's main location is in
mp_party String Labour Political party of the member of parliament who represents parliamentary constituency that the food bank's main location is in
ward String Streatham Hill Name of the ward the food bank's main location is in
district String Lambeth Name of the district the food bank's main location is in
urls
html URL https://www.givefood.org.uk/needs/in/constituency/vauxhall/ HTML URL of the parliamentary constituency
self URL https://www.givefood.org.uk/api/2/constituency/vauxhall/ API URL of the parliamentary constituency
postcode String GU16 7HF
slug String hull Slugified name of the food bank
urls
html URL https://www.givefood.org.uk/needs/at/norwoodbrixton/brixton/ HTML URL of the location
format

needs

The latest 100 food bank needs that we've discovered.

Field Type Example Description
found Date Time 2019-07-27T17:59:21.975Z Date and time we first found the food bank request
foodbank
name String Hull
slug String hull Slugified name of the food bank
urls
self URL https://www.givefood.org.uk/api/2/foodbank/hull/
html URL https://www.givefood.org.uk/needs/at/hull/
id Eight character string dc437c31 Unique need identifier
needs Multiline String Jam
Coffee
Tinned Fruit
Tinned Meat
Linebreak separated list of items in the need. Or "Unknown", or "Nothing" keywords.
self URL https://www.givefood.org.uk/api/2/foodbank/dc437c31/
format

need

When given a need identifier returns the details of that need.

Field Type Example Description
found Date Time 2019-07-27T17:59:21.975Z Date and time we first found the food bank request
foodbank
name String Hull
slug String hull Slugified name of the food bank
urls
self URL https://www.givefood.org.uk/api/2/foodbank/hull/
html URL https://www.givefood.org.uk/needs/at/hull/
id Eight character string dc437c31 Unique need identifier
needs Multiline String Jam
Coffee
Tinned Fruit
Tinned Meat
Linebreak separated list of items in the need. Or "Unknown", or "Nothing" keywords.
self URL https://www.givefood.org.uk/api/2/foodbank/dc437c31/
id
format

constituency

Returns details of a parliamentary constituency, it's MP and the food banks that reside in it and what they are asking to have donated.

Field Type Example Description
foodbanks
lat_lng String 51.4630738,-0.1207938 Comma separated latitude and longitude
name String Hull
needs Multiline String UHT Milk
Tinned Tomatoes
Tinned Sweetcorn
Custard
Linebreak separated list of items in the need. Or "Unknown", or "Nothing" keywords.
slug String hull Slugified name of the food bank
urls
homepage URL https://norwoodbrixton.foodbank.org.uk/ Homepage of the food bank
html URL https://www.givefood.org.uk/needs/in/sid-valley/ HTML URL of the food bank
self URL https://www.givefood.org.uk/api/2/foodbank/sid-valley/ API URL of the food bank
shopping_list URL https://norwoodbrixton.foodbank.org.uk/give-help/donate-food/ URL of the shopping list where we find what a food bank requires
mp
name String Florence Eshalomi Name of the MP representing the parliamentary constituency
party String Labour Name of the party the MP representing the parliamentary constituency is a member of
urls
html URL https://members.parliament.uk/member/4870/contact HTML URL of the MP
name String Vauxhall Name of the parlimentary constituency
slug String vauxhall Slug of the parlimentary constituency
urls
self URL https://www.givefood.org.uk/api/2/constituency/exeter/ API URL of the parliamentary constituency
html URL https://www.givefood.org.uk/needs/in/constituency/orkney-and-shetland/ HTML URL of the parliamentary constituency
Parliamentary Constituency
format