Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wastecheck.co.uk/llms.txt

Use this file to discover all available pages before exploring further.

​
Quickstart

Follow these steps to make your first WasteCheck API call.
1

Sign up for a developer account

Create a free account at portal.wastecheck.co.uk/signup. You will receive a confirmation email to verify your address.
2

Create a test API key

Once logged in, go to API Keys and click Create New Key. Select Test mode for development. Copy the key — it starts with wc_test_ and is only shown once.
3

Make your first API call

Verify a waste carrier against the Environment Agency register:
curl -X POST https://api.wastecheck.co.uk/v1/verify-carrier \
  -H "Authorization: Bearer wc_test_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"registration_number": "CBDU217016"}'
4

Check the response

A successful verification returns:
{
  "status": "valid",
  "verification": {
    "checked_at": "2026-03-25T14:30:00Z",
    "source": "environment_agency",
    "cached": false
  },
  "registrations": [{
    "registration_number": "CBDU217016",
    "business_name": "ACME WASTE SERVICES LTD",
    "company_number": "12345678",
    "tier": "upper",
    "status": "valid",
    "expiry_date": "2027-01-15",
    "days_until_expiry": 298,
    "expiry_warning": false
  }],
  "compliance": {
    "is_compliant": true,
    "flags": [],
    "recommendation": "Registration is valid and current."
  }
}

​
Next Steps

Now that you have made your first API call: