API Docs
- 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
- constituencies
- List of all parliamentary constituencies
- constituency
- Parliamentary constituency
foodbanks
Returns a list of all known food banks, with limited information about them.
| Field | Type | Example | Description |
|---|---|---|---|
| id | UUID | d3268f14-4e5f-4f3d-8e3a-9b0c5d6e7f8a | Unique identifier for the food bank |
| 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 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 |
|---|---|---|---|
| id | UUID | d3268f14-4e5f-4f3d-8e3a-9b0c5d6e7f8a | Unique identifier for the food bank |
| 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 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 |
| needs | |||
| found | Date time | 2020-11-27T09:55:57.877Z | Date and time of when we found what the food bank needs |
| needs | Multiline String | UHT Milk Tinned Tomatoes Tinned Sweetcorn Custard |
Linebreak separated list of items in the need. Or "Unknown", "Nothing" or "Facebook" keywords. |
| number | Integer | 6 | Number of different items requested by the food bank |
| excess | Multiline String | Baked Beans Pasta |
Linebreak separated list of items the food bank has excess of |
| 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 |
foodbank/search
When given a location (either latitude and longitude or an address) returns the details of the closest open food banks, including what is being requested to have donated.
| Field | Type | Example | Description |
|---|---|---|---|
| id | UUID | d3268f14-4e5f-4f3d-8e3a-9b0c5d6e7f8a | Unique identifier for the food bank |
| 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 |
| distance_m | Float | 5218 | Distance from the inputted location to this food bank in metres |
| distance_mi | Float | 7.12 | Distance from the inputted location to this food bank in miles to two decimal places |
| 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 |
| needs | |||
| found | Date time | 2020-11-27T09:55:57.877Z | Date and time of when we found what the food bank needs |
| needs | Multiline String | UHT Milk Tinned Tomatoes Tinned Sweetcorn Custard |
Linebreak separated list of items in the need. Or "Unknown", "Nothing" or "Facebook" keywords. |
| number | Integer | 6 | Number of different items requested by the food bank |
| excess | Multiline String | Baked Beans Pasta |
Linebreak separated list of items the food bank has excess of |
| 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 | |||
| 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 |
| 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 |
| search | |
| format |
locations
Returns a list of all known food bank locations, with limited information about them.
| Field | Type | Example | Description |
|---|---|---|---|
| id | UUID | d3268f14-4e5f-4f3d-8e3a-9b0c5d6e7f8a | Unique identifier for the location |
| address | Multiline String | Sidmouth Youth Centre Manstone Lane Sidmouth EX10 9TS |
|
| 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 |
locations/search
When given a location (either latitude and longitude or an address) returns the details of the closest open food banks locations, including what is being requested to have donated.
| Field | Type | Example | Description |
|---|---|---|---|
| id | UUID | d3268f14-4e5f-4f3d-8e3a-9b0c5d6e7f8a | Unique identifier for the location |
| address | Multiline String | Sidmouth Youth Centre Manstone Lane Sidmouth EX10 9TS |
|
| distance_m | Float | 5218 | Distance from the inputted location to this food bank in metres |
| distance_mi | Float | 7.12 | Distance from the inputted location to this food bank in miles to two decimal places |
| Email Address | info@sidvalleyfoodbank.org.uk | ||
| foodbank | |||
| name | String | Sid Valley | Name of the food bank location |
| 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 | |
| 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 |
| needs | |||
| found | Date time | 2020-11-27T09:55:57.877Z | Date and time of when we found what the food bank needs |
| needs | Multiline String | UHT Milk Tinned Tomatoes Tinned Sweetcorn Custard |
Linebreak separated list of items in the need. Or "Unknown", "Nothing" or "Facebook" keywords. |
| number | Integer | 6 | Number of different items requested by the food bank |
| excess | Multiline String | Baked Beans Pasta |
Linebreak separated list of items the food bank has excess of |
| 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 |
| search | |
| 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 | UUID | dc437c31-e590-40c9-8f35-1c6d3e68a023 | Unique need identifier |
| needs | Multiline String | Jam Coffee Tinned Fruit Tinned Meat |
Linebreak separated list of items in the need. Or "Unknown", "Nothing" or "Facebook" keywords. |
| excess | Multiline String | Baked Beans Pasta |
Linebreak separated list of items the food bank has excess of |
| 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 | UUID | dc437c31-e590-40c9-8f35-1c6d3e68a023 | Unique need identifier |
| needs | Multiline String | Jam Coffee Tinned Fruit Tinned Meat |
Linebreak separated list of items in the need. Or "Unknown", "Nothing" or "Facebook" keywords. |
| excess | Multiline String | Baked Beans Pasta |
Linebreak separated list of items the food bank has excess of |
| self | URL | https://www.givefood.org.uk/api/2/foodbank/dc437c31/ | |
| id | |
| format |
constituencies
Returns a list of all UK parliamentary constituencies
| Field | Type | Example | Description |
|---|---|---|---|
| name | String | Vauxhall | Name of the parliamentary constituency |
| slug | String | vauxhall | Slugified name of the parliamentary constituency |
| country | String | England | Country that the parliamentary constituency is in |
| 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 |
| id | Integer | 1234 | Parliamentary member ID for the MP |
| urls | |||
| html | URL | https://members.parliament.uk/member/4870/contact | HTML URL of the MP |
| photo | URL | https://www.givefood.org.uk/static/img/mp/4510.jpg | URL of a photo of the MP |
| urls | |||
| html | URL | https://www.givefood.org.uk/needs/at/norwoodbrixton/ | HTML URL of the parliamentary constituency |
| self | URL | https://www.givefood.org.uk/api/2/foodbank/norwoodbrixton/ | API URL of the parliamentary constituency |
| parliament | URL | https://members.parliament.uk/member/4510/contact | URL of the MP at parliament.uk |
| 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", "Nothing" or "Facebook" keywords. |
| excess | Multiline String | Baked Beans Pasta |
Linebreak separated list of items the food bank has excess of |
| 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 |
| id | Integer | 1234 | Parliamentary member ID for the MP |
| urls | |||
| html | URL | https://members.parliament.uk/member/4870/contact | HTML URL of the MP |
| photo | URL | https://www.givefood.org.uk/static/img/mp/4510.jpg | URL of a photo 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 |