Skip to content

API Integration

All waste collection data is available through an open HTTP API. The API is the foundation of every integration – use it directly in your own applications, scripts or smart home systems.

Endpoint

The central endpoint returns all collection dates for an address grouped by waste type as JSON. It is the same endpoint used in the openHAB integration:

POSThttps://binable.app/api/fetch

Method: POST · Response: JSON · An API key is optional – anonymous requests are possible but may be rate-limited more strictly.

With an API key you get higher rate limits. Simply add the header Authorization: ApiKey <your-key>. Get free API key

Passing the address

The address can be passed in three different ways – choose whichever fits your system best.

The following fields are used: street, houseNumber, zip, city and country (ISO 3166-1 alpha-2 country code, e.g. DE).

Query parameters

Append the address fields to the URL (umlauts/special characters must be URL-encoded):

https://binable.app/api/fetch?street=Musterstra%C3%9Fe&houseNumber=1a&zip=12345&city=Musterstadt&country=DE

HTTP headers

Pass the address via X-Address-* headers – this is what the openHAB integration uses. Note: no umlauts/special characters in headers, write "ue" instead of "ü".

X-Address-Street: Musterstrasse
X-Address-HouseNumber: 1a
X-Address-Zip: 12345
X-Address-City: Musterstadt
X-Address-Country: DE

JSON body

Send the address as a JSON object in the request body:

{
  "street": "Musterstraße",
  "houseNumber": "1a",
  "zip": "12345",
  "city": "Musterstadt",
  "country": "DE"
}

Example: curl call

A complete call with a JSON body looks like this:

curl -X POST https://binable.app/api/fetch \
  -H "Content-Type: application/json" \
  -d '{
    "street": "Musterstraße",
    "houseNumber": "1a",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  }'

The same call with an API key:

curl -X POST https://binable.app/api/fetch \
  -H "Authorization: ApiKey <dein-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"street":"Musterstraße","houseNumber":"1a","zip":"12345","city":"Musterstadt","country":"DE"}'

← Integration overview  ·  Full API documentation