---
title: "Cancel Monitoring"
method: DELETE
path: "/monitoring/{identifier}"
tags: ["Monitoring"]
---

# Cancel Monitoring

`DELETE /monitoring/{identifier}`

## Request

- Base URL: `https://api.burodeingresos.com`
- URL: `https://api.burodeingresos.com/monitoring/{identifier}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/docs/monitoring/:identifier/delete.ts> (a function with typed inputs; its response is checked against the schema)

Cancels the monitoring of an identifier: it is no longer verified each month. Idempotent: a monitoring that is not `active` is returned as it is. To resume it, enroll the identifier again.

## Path parameters

- `identifier` string, required

## Response `200`

The monitoring, as it stands after the cancellation.

- Monitoring
  - `id` string, uuid: Unique identifier of the monitoring.
  - `identifier` string: The monitored identifier.
  - `status` 'active' | 'cancelled' | 'expired': `active`: verified about once a month. `cancelled`: cancelled by your company. `expired`: its consent ran out.
  - `enrolled_at` string, date-time: When the identifier was enrolled.
  - `expires_at` string, date-time, nullable: When the monitoring expires: its consent's expiry. Always present; null when the monitoring was enrolled with `ip_address` and does not expire.
  - `cancelled_at` string, date-time: When the monitoring was cancelled. Present only when it was cancelled.

## Other responses

- `401`: Unauthorized - Invalid or missing API key.
- `404`: Not Found - The identifier is not enrolled in monitoring for your company.

## Changes

- **2026-11-03** `98eb3984cffb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/changes/monitoring/:identifier/delete.md)

---

[API](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api.md) - [All operations](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/llms.txt) - [OpenAPI document](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/revisions/98eb3984cffb?raw)