Verify Carrier
API Reference
Verify Carrier
Verify a waste carrier’s registration against the Environment Agency register
POST
Verify Carrier
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.
Requires authentication via
Authorization header. See Authentication.Request
Method:POST (or GET with query parameters)
Path: /v1/verify-carrier
Headers
Bearer token with your API key, e.g.
Bearer wc_live_your_keyMust 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)
Overall status:
valid, expiring_soon, expired, not_found, or lower_tierMetadata 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. Theverification.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 |