> For the complete documentation index, see [llms.txt](https://api.documentation.omnicado.com/llms.txt)

# Cancel a custom label

> DELETE /labels/custom/{reference}
> 
> Cancels the parcel with the carrier (Packeta, GLS, PPL). DPD shipments cannot be cancelled through the API; cancel them in DPD. A cancelled reference cannot be used again.



## Servers
- Production API endpoint - live use only: api.services.omnicado.com/api/v2 (Production API endpoint - live use only)
- Development API endpoint - used for testing: api.dev.services.omnicado.com/api/v2 (Development API endpoint - used for testing)


## Authentication methods
- Omnicado token based scheme


## Parameters

### Path parameters

- **reference** (string)
  The `reference` the label was printed with




## Responses
### 200
Label cancelled

#### Body: application/json (object)
- **reference** (string)

- **cancelled** (boolean)


### 404
`label_not_found`

#### Body: application/json (object)
- **error** (string)

- **code** (string)
  Machine-readable reason, listed with each response


### 422
`cancel_not_supported` (DPD)

#### Body: application/json (object)
- **error** (string)

- **code** (string)
  Machine-readable reason, listed with each response


### 502
`carrier_error`

#### Body: application/json (object)
- **error** (string)

- **code** (string)
  Machine-readable reason, listed with each response



[Powered by Bump.sh](https://bump.sh)
