> ## 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

> Retrieve a previously generated Waste Transfer Note

# 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.

<Note>
  Requires authentication via `Authorization` header. See [Authentication](/authentication).
</Note>

## Request

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

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token with your API key, e.g. `Bearer wc_live_your_key`
</ParamField>

### Path Parameters

<ParamField path="reference" type="string" required>
  The WTN reference returned when it was created (e.g. `WTN-2026-0325-A7X9`)
</ParamField>

## Response

### Success Response (200)

Returns the full WTN object as shown in the [POST /v1/generate-wtn](/api-reference/generate-wtn) response, including producer, carrier, waste, destination, duty of care, and compliance objects.

```json theme={null}
{
  "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

| Code            | HTTP | When                                                           |
| --------------- | ---- | -------------------------------------------------------------- |
| `WTN_NOT_FOUND` | 404  | Reference doesn't exist or belongs to a different organisation |

```json theme={null}
{
  "error": {
    "code": "WTN_NOT_FOUND",
    "message": "No Waste Transfer Note matches the given reference.",
    "status": 404
  }
}
```

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.wastecheck.co.uk/v1/wtn/WTN-2026-0325-A7X9 \
    -H "Authorization: Bearer wc_live_your_api_key_here"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.wastecheck.co.uk/v1/wtn/WTN-2026-0325-A7X9",
    {
      headers: {
        "Authorization": "Bearer wc_live_your_api_key_here",
      },
    }
  );
  const data = await response.json();
  console.log(data.reference); // "WTN-2026-0325-A7X9"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.wastecheck.co.uk/v1/wtn/WTN-2026-0325-A7X9",
      headers={
          "Authorization": "Bearer wc_live_your_api_key_here",
      },
  )
  data = response.json()
  print(data["reference"])  # "WTN-2026-0325-A7X9"
  ```
</CodeGroup>