Skip to main content
GET
/
v1
/
wtn
/
{reference}
Retrieve WTN
curl --request GET \
  --url https://api.example.com/v1/wtn/{reference} \
  --header 'Authorization: <authorization>'

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.

Retrieve WTN

Retrieves a previously generated Waste Transfer Note by its unique reference. WTNs are scoped to the organisation that created them. You cannot retrieve another organisation’s WTNs.
Requires authentication via Authorization header. See Authentication.

Request

Method: GET Path: /v1/wtn/{reference}

Headers

Authorization
string
required
Bearer token with your API key, e.g. Bearer wc_live_your_key

Path Parameters

reference
string
required
The WTN reference returned when it was created (e.g. WTN-2026-0325-A7X9)

Response

Success Response (200)

Returns the full WTN object as shown in the POST /v1/generate-wtn response, including producer, carrier, waste, destination, duty of care, and compliance objects.
{
  "reference": "WTN-2026-0325-A7X9",
  "status": "complete",
  "producer": {
    "name": "ABC Office Fit-out Ltd",
    "address": "45 High Street, Bournemouth, BH1 2AA",
    "sic_code": "43320"
  },
  "carrier": {
    "registration_number": "CBDU217016",
    "business_name": "ACME WASTE SERVICES LTD",
    "tier": "upper",
    "verified": true,
    "expiry_date": "2027-01-15"
  },
  "waste": {
    "description": "Broken plasterboard from office refurbishment",
    "ewc_code": "17 08 02",
    "ewc_description": "Gypsum-based construction materials",
    "is_hazardous": false,
    "quantity_kg": 2500,
    "container_type": "skip"
  },
  "destination": {
    "name": "South Coast Recycling Ltd",
    "address": "Industrial Estate, Poole, BH15 1NF",
    "permit_number": "EPR/AB1234CD"
  },
  "duty_of_care": {
    "producer_identified": true,
    "carrier_verified": true,
    "waste_classified": true,
    "destination_provided": true,
    "all_checks_passed": true
  },
  "compliance": {
    "is_compliant": true,
    "flags": [],
    "warnings": []
  },
  "transfer_date": "2026-03-25",
  "created_at": "2026-03-25T14:32:00Z"
}

Error Responses

CodeHTTPWhen
WTN_NOT_FOUND404Reference doesn’t exist or belongs to a different organisation
{
  "error": {
    "code": "WTN_NOT_FOUND",
    "message": "No Waste Transfer Note matches the given reference.",
    "status": 404
  }
}

Example

curl https://api.wastecheck.co.uk/v1/wtn/WTN-2026-0325-A7X9 \
  -H "Authorization: Bearer wc_live_your_api_key_here"