---
id: aiorecollect
version: "2023.12.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# aiorecollect — A Python 3, asyncio-based library for the ReCollect Waste API

License: permissive · Maintenance: active · Downloads: 74.0K/mo

## What it is and what it does

aiorecollect is an asyncio-based Python client for the ReCollect Waste API, a service used by municipalities to publish waste pickup schedules. It wraps HTTP calls to ReCollect's endpoints and returns structured pickup events—each with a date, list of pickup types (trash, recycling, compost, etc.), and area name. The library depends on aiohttp for async HTTP transport, certifi for SSL verification, and yarl and frozenlist as aiohttp transitive dependencies.

You instantiate a Client with your municipality's Place and Service IDs (found in your waste calendar's iCal URL), then call async methods to fetch all pickup events, events within a date range, or the next upcoming pickup. The library supports optional connection pooling via an aiohttp ClientSession to reduce overhead when making many requests. It is actively maintained, supports Python 3.10–3.12, and has no known security vulnerabilities.

Use it for:

- Fetch waste pickup dates for a residential property and display them in a home automation dashboard.
- Build a reminder system that alerts users of upcoming trash or recycling collection days.
- Aggregate pickup schedules from multiple municipalities into a single calendar application.
- Integrate waste collection data into a smart home routine that adjusts schedules based on pickup types.
- Query historical or future pickup events to analyze collection patterns in a municipality.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asyncio-based Python library for querying waste pickup schedules from the ReCollect Waste API, returning pickup dates, types, and area information.

Yes. The library is actively maintained, has no security vulnerabilities, uses permissive MIT licensing, and has low install friction. Install it if you need to programmatically access ReCollect waste schedules; skip it if your municipality does not use ReCollect or if you prefer synchronous HTTP calls.

## Install

pip install aiorecollect
uv add aiorecollect
poetry add aiorecollect

## Installing aiorecollect

Before you install: Low install friction with four lightweight runtime dependencies. Actively maintained as of August 2026, with last commit on 2026-08-09 and supported on Python 3.10, 3.11, and 3.12.

License in practice: MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install aiorecollect

import asyncio
from aiorecollect import Client

async def main():
    client = await Client("PLACE_ID", "SERVICE_ID")
    events = await client.async_get_pickup_events()
    print(events)

asyncio.run(main())

Requires Python 3.10 or later; you must obtain your ReCollect Place and Service IDs from your municipality's iCal subscription URL.

Verify before relying:

- Whether the library handles rate limiting or connection failures gracefully beyond what aiohttp provides.
- Performance characteristics when querying large date ranges or high-frequency polling scenarios.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 74.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

waste pickup schedule api, recollect waste calendar, trash collection dates, asyncio waste management, recycling pickup events, municipal waste api client, waste-management, municipal-api, async-http

[View on SkillFed](https://skillfed.io/packages/aiorecollect) · [View on PyPI](https://pypi.org/project/aiorecollect/)