Digital Waste Tracking Receipt API

v2

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-0171058.4 KB

Endpoint used when waste is received and the receiver submits a waste movement. A waste tracking ID is returned in a 201 response when the movement is successfully stored.

post/movements/receive

Request body

apiCodestring uuid required

This is the unique sixteen byte identifier of the receiving organisation produced by the registration process found within the Waste Tracking Service.

dateTimeReceivedstring date-time required

This is the date and exact time waste was received at the site. This API uses the UTC ISO 8601 and BST standards for machine-readable dates and times. Key Differences: UTC is the global time standard and does not observe daylight saving time. BST is UTC+1, used in the UK during daylight saving time (typically from late March to late October).

hazardousWasteConsignmentCodestring

Hazardous waste consignment code. If the EWC is HAZ, then this field is mandatory. England & Wales: Format- XXXXXX/YYYYY Where XXXXXX can be a mixture of letters and/or numbers, i.e. alphanumeric. The consignment note code must follow the format- XXXXXX/YYYYY. The first XXXXXX part is made up of six alphanumeric characters and must be followed by a forward slash / The YYYYY part is a five alphanumeric character unique identifier of the users' choice (no spaces or symbols). Scotland Format- SA, SB or SC followed by a 7-digit number (e.g. SB1234567). Also known as Special Waste Consignment Note Northern Ireland and Eire: Format- DA, DB or DC followed by a 7-digit number (e.g. DA5301234) <a href="https://www.gov.uk/guidance/hazardous-waste-consignment-note-supplementary-guidance#a1-consignment-note-code">More information here</a> Business Rules: <ul> <li>If receiveMovementRequest.hazardousWasteConsignmentCode is provided it must be in specified format.</li> <li>If all waste.ewcCodes provided are considered “not hazardous” receiveMovementRequest.hazardousWasteConsignmentCode is not required.</li> </ul>

reasonForNoConsignmentCode'Non-Haz Waste Transfer' | 'No documentation provided with Waste' | 'Household Waste Recycling Centre Receipt'

If you have not provided a hazardous waste consignment code, then there are three reason codes you can choose to provide. See the table below. <table border="1"> <thead> <tr> <th>Reason</th> <th>Reason Code</th> </tr> </thead> <tbody> <tr> <td>Non-Haz Waste Transfer</td> <td>NON_HAZ_WASTE_TRANSFER</td> </tr> <tr> <td>No documentation provided with Waste</td> <td>NO_DOC_WITH_WASTE</td> </tr> <tr> <td>Household Wast Recycling Centre Receipt</td> <td>HWRC_RECEIPT</td> </tr> </tbody> </table> Note: The field is case-sensitive, please use the case for the code specified in the table. Business Rules: <ul> <li>If any waste.ewcCodes provided are considered hazardous and receiveMovementRequest.hazardousWasteConsignmentCode is not provided a receiveMovementRequest.reasonForNoConsignmentCode is required.</li> <li>If receiveMovementRequest.hazardousWasteConsignmentCode is provided it must be either “NON_HAZ_WASTE_TRANSFER”, “NO_DOC_WITH_WASTE” or “HWRC_RECEIPT”. </li> </ul>

yourUniqueReferencestring

This could be a unique weighbridge ticket number, waste transfer note number etc.

specialHandlingRequirementsstring

Required when abnormal hazardous waste and some non-hazardous waste contains harmful chemical, biological or physical characteristics that require some special handling to prevent harm.

Example request

{
  "apiCode": "ba6eb330-4f7f-11eb-a2fb-67c34e9ac07cg",
  "dateTimeReceived": "UTC - 2025-09-15T12:12:28Z, BST - 2025-09-15T13:12:28+01:00",
  "hazardousWasteConsignmentCode": "CJ32LE/A0001",
  "reasonForNoConsignmentCode": "NO_DOC_WITH_WASTE",
  "yourUniqueReference": "wTBrdgAA020",
  "otherReferencesForMovement": [
    {
      "label": "PO Number",
      "reference": "PO-12345"
    },
    {
      "label": "Waste Ticket",
      "reference": "WT-67890"
    },
    {
      "label": "Haulier Note",
      "reference": "HN-11111"
    }
  ],
  "specialHandlingRequirements": "The waste must be fully inspected by the waste handler according to the Hazardous waste consignment and or EWC codes provided.",
  "wasteItems": [
    {
      "ewcCodes": [
        200108,
        150109
      ],
      "wasteDescription": "Basic mixed construction and demolition waste, this includes recyclable house bricks, gypsum plaster and slates.",
      "physicalForm": "Sludge",
      "numberOfContainers": 2,
      "typeOfContainers": "SKI",
      "weight": {
        "metric": "Tonnes",
        "amount": 150,
        "isEstimate": true
      },
      "containsPops": true,
      "pops": {
        "sourceOfComponents": "PROVIDED_WITH_WASTE",
        "components": [
          {
            "code": "PFHXS",
            "concentration": 12.5
          }
        ]
      },
      "containsHazardous": true,
      "hazardous": {
        "sourceOfComponents": "PROVIDED_WITH_WASTE",
        "hazCodes": [
          "HP_5",
          "HP_10"
        ],
        "components": [
          {
            "name": "lead",
            "concentration": 25.5
          }
        ]
      },
      "disposalOrRecoveryCodes": [
        {
          "code": "\"R1\"\n",
          "weight": {
            "metric": "Tonnes",
            "amount": 150,
            "isEstimate": true
          }
        }
      ]
    }
  ],
  "carrier": {
    "registrationNumber": "CBDL6",
    "reasonForNoRegistrationNumber": "ON_SITE",
    "organisationName": "Waste Carriers Lite Ltd",
    "address": {
      "fullAddress": "26a Oil Drum Lane, London, UK",
      "postcode": "W12 7ZL"
    },
    "emailAddress": "mailbox@example.co.uk",
    "phoneNumber": "020 4756 XXXX",
    "vehicleRegistration": "RNT 493",
    "meansOfTransport": "Rail"
  },
  "brokerOrDealer": {
    "organisationName": "Waste Disposal Ltd",
    "address": {
      "fullAddress": "26a Oil Drum Lane, London, UK",
      "postcode": "W12 7ZL"
    },
    "emailAddress": "mailbox@example.co.uk",
    "phoneNumber": "020 4756 XXXX",
    "registrationNumber": "CBDL6"
  },
  "receiver": {
    "emailAddress": "mailbox@example.co.uk",
    "phoneNumber": "020 4756 XXXX",
    "authorisationNumber": "EPR/DD2522BF",
    "regulatoryPositionStatements": [
      343,
      456,
      789
    ]
  },
  "receipt": {
    "address": {
      "fullAddress": "26a Oil Drum Lane, London, UK",
      "postcode": "W12 7ZL"
    }
  }
}

Response

Success- The waste movement has been stored.

wasteTrackingIdstring

Globally unique identifier of the movement. This ID should be stored and used for any subsequent updates of the movement. It is returned in the response body when a POST request is successful, i.e. return code 201.

Example response

{
  "wasteTrackingId": "25HRA0B2",
  "validation": {
    "warnings": [
      {
        "key": "wasteItems[0].disposalOrRecoveryCodes",
        "errorType": "NotProvided",
        "message": "Success/Failure"
      }
    ]
  }
}

All 7 operations