---
title: "End an equipment lifecycle"
method: DELETE
path: "/api/v1/vehicles/{id}/checks"
tags: ["Equipment"]
---

# End an equipment lifecycle

`DELETE /api/v1/vehicles/{id}/checks`

## Request

- Base URL: `https://fleetkeep.co.uk`
- URL: `https://fleetkeep.co.uk/api/v1/vehicles/{id}/checks`
- Auth: OAuth 2 (authorization code, authorization URL `https://fleetkeep.co.uk/auth/oauth2/authorize`, token URL `https://fleetkeep.co.uk/auth/oauth2/token`, scopes: `vehicles:write`)

Preserves the record as history; it does not hard-delete it. First call with the record ID and removal date returns a five-minute confirmation token. Retry the identical request with X-Fleetkeep-Confirmation. The token is bound to the user, bearer token, equipment version and removal date.

## Headers

- `X-Fleetkeep-Confirmation` string

## Request body

- object
  - `id` string, uuid, required
  - `removedOn` string, date, required

## Response `200`

Equipment moved to lifecycle history.

- EquipmentRemovalResult
  - `ok` true, required
  - `equipment` object, required
    - `id` string, uuid, required
    - `status` 'removed', required
    - `active` false, required

## Other responses

- `400`: The request body or query was invalid.
- `401`: Missing or invalid Bearer access token.
- `403`: Token does not include the required scope.
- `404`: The requested resource does not exist on the authorised user's account, is the wrong event type, or is immutable history for this operation.
- `409`: Confirmation is required, invalid, expired or invalidated.
- `429`: Per-token rate limit exceeded (60 requests per minute).

---

[API](https://skmtc.dev/fleetkeep/apis/fleetkeep-api.md) · [All operations](https://skmtc.dev/fleetkeep/apis/fleetkeep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fleetkeep/apis/fleetkeep-api/revisions/ace19bc0d64d?raw)