---
title: "Get Monitoring"
method: GET
path: "/monitoring/{identifier}"
tags: ["Monitoring"]
---

# Get Monitoring

`GET /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/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the monitoring of an identifier for your company, in any status (`active`, `cancelled` or `expired`).

## Path parameters

- `identifier` string, required

## Response `200`

The monitoring.

- 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/get.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)