---
title: "Delete a Goods Movement Record"
method: DELETE
path: "/customs/goods-movement-system/movements/{gmrId}"
---

# Delete a Goods Movement Record

`DELETE /customs/goods-movement-system/movements/{gmrId}`

## Request

- Base URL: `https://api.service.hmrc.gov.uk`
- URL: `https://api.service.hmrc.gov.uk/customs/goods-movement-system/movements/{gmrId}`
- Auth: OAuth 2
  - Authorization code: `https://api.service.hmrc.gov.uk/oauth/authorize`
  - Token URL: `https://api.service.hmrc.gov.uk/oauth/token` scopes: `write:goods-movement-system`
- TypeScript: <https://skmtc.dev/hmrc/apis/goods-movement-system-haulier-api/docs/customs/goods-movement-system/movements/:gmrId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Use this to delete a GMR for movements which have not yet been checked in. This will make any declaration IDs previously added to the GMR available for use in another GMR.This endpoint gets a Goods Movement Record (GMR)

## Path parameters

- `gmrId` string, required: The ID of a Goods Movement Record (GMR)

## Headers

- `Accept` string, required
- `Authorization` string, required

## Response `202`

The goods movement record delete request has been accepted. Use the Push Pull Notifications API to retrieve confirmation of the deleted GMR. After receiving this confirmation you will be able to use declaration IDs previously added to the deleted GMR in a new GMR.

## Other responses

- `400`
- `403`
- `404`

---

[API](https://skmtc.dev/hmrc/apis/goods-movement-system-haulier-api.md) - [All operations](https://skmtc.dev/hmrc/apis/goods-movement-system-haulier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hmrc/apis/goods-movement-system-haulier-api/revisions/9ff4efa9be1c?raw)