Quick Start

Getting Started

Authenticate, set your base URL, and make your first API call in minutes.

All API requests require an API key sent via the X-Api-Key header.

X-Api-Key: YOUR_API_KEY

All endpoints are served from a single base URL.

https://api.dsposal.uk

Try searching the Waste Thesaurus for "concrete":

1curl -X GET "https://api.dsposal.uk/v1/public/waste-thesaurus/search?q=concrete" \2  -H "X-Api-Key: YOUR_API_KEY"

Reference

Error Handling

The API uses standard HTTP status codes. Error responses follow the ProblemDetails format (RFC 9457).

400

Bad Request

Check your query parameters.

401

Unauthorized

Missing or invalid API key.

403

Forbidden

Your key does not have access to this resource.

404

Not Found

The resource does not exist.

Get started with Dsposal APIs. Request an API key and integrate waste data into your applications today.