# Henteplan

> Norwegian waste collection schedule API and web app.

Henteplan provides a free, open API for looking up waste collection schedules across Norway. It supports 13+ providers covering 200+ municipalities.

## Links

- Website: https://henteplan.no
- API Documentation: https://henteplan.no/docs
- OpenAPI Spec: https://henteplan.no/openapi.json
- Source Code: https://github.com/henrikkvamme/henteplan

## API Endpoints

- GET /api/v1/providers — List all supported waste collection providers
- GET /api/v1/detect?postalCode={code}&city={city} — Auto-detect provider for an address
- GET /api/v1/search?q={address}&provider={id} — Search for addresses within a provider
- GET /api/v1/schedule?provider={id}&locationId={id} — Get waste collection schedule
- GET /api/v1/schedule.ics?provider={id}&locationId={id} — Download iCal calendar
- GET /api/v1/status — Provider health status and uptime data

## Rate Limits

All endpoints are rate-limited per IP. Requests include `X-RateLimit-Limit` and `X-RateLimit-Remaining` headers.

- /api/v1/search: 30 req/min
- /api/v1/schedule, /api/v1/schedule.ics: 60 req/min
- /api/v1/providers, /api/v1/detect: 120 req/min

## Error Handling

Errors return JSON with `{ "error": "<message>" }` and standard HTTP status codes:
- 400 — Bad request (missing or invalid parameters)
- 404 — Not found
- 429 — Rate limit exceeded (retry after Retry-After header)
- 500 — Internal server error

## Supported Providers

- Trondheim Renholdsverk (trv): Trondheim
- BIR (bir): Bergen, Askøy, Bjørnafjorden, Eidfjord, Kvam, Osterøy, Samnanger, Ulvik, Vaksdal, Voss
- Oslo Kommune (oslo): Oslo
- MinRenovasjon (Norkart) (norkart): ~198 kommuner
- Avfall Sør (avfallsor): Kristiansand, Vennesla
- HIM (him): Haugesund, Karmøy, Tysvær, Bokn, Vindafjord, Etne
- ReMidt (remidt): Kristiansund, Molde, Orkland, Sunndal, Surnadal, Oppdal, Smøla
- Fosen Renovasjon (fosen): Indre Fosen, Orland, Afjord
- FREVAR (frevar): Fredrikstad
- IRIS Salten (iris): Bodø, Fauske, Saltdal, Sørfold, Steigen, Gildeskål, Meløy, Beiarn
- RfD (rfd): Drammen, Lier, Øvre Eiker, Modum
- Renovasjonen IKS (renovasjonen): Stavanger, Sandnes
- Innherred Renovasjon (innherred): Levanger, Verdal, Inderøy, Snåsa