A simple guide to sending us your bin collection data.
Binfluencer shows residents which bin goes out next and reminds them the night before. Right now we read your published calendars. If you send us your data directly, residents get official dates straight from you, including holiday changes, and we stop reading your website. Fewer "when's my bin day?" calls for everyone.
Whichever way you choose, we need the same three things:
Homes on the same round share one calendar, so you only send the dates once per round, not once per home.
One spreadsheet with three tabs. Excel, Google Sheets or CSV files are all fine.
| Bin | Colour | Every how many days |
|---|---|---|
| Recycling | blue | 14 |
| General | green | 21 |
| UPRN | Address | Postcode | Round |
|---|---|---|---|
| 000125006743 | 115 Alexandra Parade, Dunoon | PA23 8AW | COW_22 |
| Round | Bin | Date |
|---|---|---|
| COW_22 | Recycling | 2026-10-07 |
| COW_22 | General | 2026-10-14 |
Email it to hello@lbysoftware.co.uk.
Please write dates as year-month-day (2026-10-07) so nobody mixes up October and July.
argyll-bute) and a
private API key starting bfk_. Keep the key secret, like a password.https://iwjqwswwcxitbafaajic.supabase.co
/functions/v1/api/v1
Authorization: Bearer bfk_your_key_here
Content-Type: application/json
PUT /councils/argyll-bute/bin-types
{
"binTypes": [
{
"code": "Recycling",
"label": "Blue bin (mixed recycling)",
"colour": "blue",
"frequencyDays": 14
},
{
"code": "General",
"label": "Green bin (general waste)",
"colour": "green",
"frequencyDays": 21
}
]
}
The code is the name you'll use for that bin in step 3.
PUT /councils/argyll-bute/properties
{
"properties": [
{
"externalId": "000125006743",
"address": "115 Alexandra Parade, Dunoon",
"postcode": "PA23 8AW",
"routeKey": "COW_22"
}
]
}
externalId is the UPRN and routeKey is the collection round. Up to 5,000 homes per request, so send big lists in batches.
PUT /councils/argyll-bute/routes/COW_22
/collections
{
"collections": [
{ "binType": "Recycling", "date": "2026-10-07" },
{ "binType": "General", "date": "2026-10-14" }
]
}
This replaces every date for that round from the earliest date you send. So to make a change, just send the full, updated list again. Up to 2,000 dates per request.
GET /councils/argyll-bute/status
Shows how many homes and rounds we hold for you, when you last updated, and any rounds that are running out of dates.
curl -X PUT \
"https://iwjqwswwcxitbafaajic.supabase.co/functions/v1/api/v1/councils/argyll-bute/routes/COW_22/collections" \
-H "Authorization: Bearer bfk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"collections":[{"binType":"Recycling","date":"2026-10-07"}]}'
2026-10-07. Postcodes can be in any format.| Code | What it means |
|---|---|
| 401 | The key is missing or wrong. |
| 403 | That key belongs to a different council. |
| 400 / 422 | Something in the data needs fixing, for example a bin name we don't know or a date like 2026-13-01. The reply lists exactly which items. |
Want the full technical detail? Here's the OpenAPI specification, which your developers can load into most API tools.
Questions? We're happy to help your team get set up. Email hello@lbysoftware.co.uk.