---
title: "The fixed waste_type vocabulary"
method: GET
path: "/waste-types"
---

# The fixed waste_type vocabulary

`GET /waste-types`

## Request

- Base URL: `https://whenisbins.com/v1`
- URL: `https://whenisbins.com/v1/waste-types`
- Auth: one of:
  - none
  - HTTP bearer

## Headers

- `If-None-Match` string

## Response `200`

All waste types with display names.

- object
  - `waste_types` WasteType[], required
    - `id` 'refuse' | 'recycling' | 'garden' | 'food' | 'glass' | 'textiles' | 'electricals' | 'paper_card' | 'plastics_cans' | 'other', required
    - `display_name` string, required

## Other responses

- `304`: A 304 means stored content is unchanged, not that the council re- verified the date. The content matches the `If-None-Match` ETag. No body.
- `401`: Supplied bearer token is malformed, unknown or revoked, or a token is missing during a token-only hold (`unauthorized`).
- `405`: The path exists but not with this method. Every resource below answers exactly one method; the `Allow` header names it.
- `429`: Request, provider or new-work allowance exceeded; optional limit_scope and token_request_url explain the limit.
- `500`: An unexpected fault on our side (`server_error`). Nothing is implied about whether the work started; retry with the same `Idempotency-Key` where one applies.
- `503`: Required service configuration, a dependency, or shared lookup admission is temporarily unavailable (`service_unavailable`).

---

[API](https://skmtc.dev/whenisbins/apis/whenisbins-uk-bin-collection-api-for-apps-and-ai-agents.md) · [All operations](https://skmtc.dev/whenisbins/apis/whenisbins-uk-bin-collection-api-for-apps-and-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/whenisbins/apis/whenisbins-uk-bin-collection-api-for-apps-and-ai-agents/revisions/6e4a960474a4?raw)