---
id: aioridwell
version: "2025.9.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# aioridwell — A Python3, asyncio-based API for interacting with Ridwell waste recycling

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

## What it is and what it does

aioridwell is an asyncio-based client library for the Ridwell waste-recycling service API. It lets you authenticate with your Ridwell account, fetch associated accounts and their upcoming pickup events, and manage opt-in/opt-out preferences for individual pickups. The library wraps Ridwell's HTTP API using aiohttp for non-blocking I/O, making it suitable for integration into async applications like home-automation systems or monitoring dashboards.

The package exposes a simple async interface: create a client with credentials, retrieve accounts, then query pickup events from each account. Each pickup event contains structured data (pickup date, items, categories, priorities) and supports operations like opting in or out and estimating add-on costs. It depends on PyJWT, aiohttp, certifi, titlecase, and yarl—all standard async HTTP and utility libraries.

Use it for:

- Integrate Ridwell pickup schedules into a home-automation system to send reminders or trigger actions on pickup days.
- Build a monitoring dashboard that displays upcoming recycling pickups across multiple Ridwell accounts.
- Automate opt-in/opt-out decisions for pickup events based on custom logic or user preferences.
- Fetch and display estimated add-on costs for upcoming pickups in a personal finance or waste-tracking app.
- Query account details and subscription status programmatically for billing or account-management workflows.

## Worth the install?

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

An asyncio-based Python library for querying the Ridwell waste-recycling API to retrieve account information, upcoming pickup events, and manage pickup preferences.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and fills a clear niche for developers who need programmatic access to Ridwell's API in async Python applications. No known vulnerabilities. Install it if you need to integrate Ridwell scheduling into an async workflow.

## Install

pip install aioridwell
uv add aioridwell
poetry add aioridwell

## Installing aioridwell

Before you install: Low install friction with a pure-Python wheel. Actively maintained as of 2026-08-09 with 333 days since the latest release; supported on Python 3.10 through 3.14.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both personal and commercial projects.

Quickstart:

pip install aioridwell

import asyncio
from aioridwell import async_get_client

async def main():
    client = await async_get_client("email", "password")
    accounts = await client.async_get_accounts()
    for account in accounts.values():
        events = await account.async_get_pickup_events()

asyncio.run(main())

Requires Python 3.10 or later; credentials for a Ridwell account are needed to authenticate with the API.

Verify before relying:

- Whether the library handles token refresh or session expiration automatically.
- Rate limiting behavior and any throttling imposed by the Ridwell API.
- Error handling and retry logic for network failures or API outages.

## Package facts

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

## Tags

ridwell api client, asyncio recycling pickup, ridwell account integration, waste pickup scheduling, async ridwell events, ridwell python library, recycling service api, async-http-client, waste-recycling

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