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.
Verify Carrier
Verifies a waste carrier’s registration against the Environment Agency public register. Also available as a GET request with query parameters.
Supports three search modes: direct lookup by registration number (fastest), search by business name, or search by postcode. If multiple fields are provided, registration_number takes priority.
Request
Method: POST (or GET with query parameters)
Path: /v1/verify-carrier
Bearer token with your API key, e.g. Bearer wc_live_your_key
Must be application/json (POST only)
Body Parameters
At least one field is required.
CBDU or CBDL registration number (e.g. CBDU217016). Direct lookup — fastest.
Business name to search for
Postcode to search for registered carriers
Response
Success Response (200)
{
"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."
}
}
Overall status: valid, expiring_soon, expired, not_found, or lower_tier
Metadata about the check including timestamp, source, and cache status
Array of matching carrier registrations
Compliance assessment with flags and recommendation text
Status Values
| Status | Meaning |
|---|
valid | Active registration, not expired |
expiring_soon | Valid but within 90 days of expiry (upper tier only) |
expired | Past expiry date |
not_found | No matching registration |
lower_tier | Valid but lower tier registration only |
Compliance Flags
| Flag | Meaning |
|---|
EXPIRING_WITHIN_90_DAYS | Upper tier registration nearing expiry |
LOWER_TIER_ONLY | May not meet requirements for commercial waste |
MULTIPLE_REGISTRATIONS_FOUND | Name or postcode search returned multiple matches |
Caching
Direct lookups by registration number are cached for 24 hours. Name and postcode searches are cached for 1 hour. The verification.cached field indicates whether the result was served from cache.
Error Responses
| Code | HTTP | When |
|---|
CARRIER_NOT_FOUND | 404 | No registration matches the input |
INVALID_REGISTRATION_NUMBER | 400 | Registration number doesn’t match CBDU/CBDL format |
EA_REGISTER_UNAVAILABLE | 503 | Environment Agency register is down or unreachable |
Example
curl -X POST https://api.wastecheck.co.uk/v1/verify-carrier \
-H "Authorization: Bearer wc_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"registration_number": "CBDU217016"}'