---
title: "Retrieve a Company Monitoring check"
method: GET
path: "/v1/checks/company-monitoring/{id}"
tags: ["Company Monitoring check"]
---

# Retrieve a Company Monitoring check

`GET /v1/checks/company-monitoring/{id}`

## Request

- Base URL: `https://api.dotfile.com`
- URL: `https://api.dotfile.com/v1/checks/company-monitoring/{id}`
- Auth: API key in header `X-DOTFILE-API-KEY`

Returns detailed information about the specified Company Monitoring check.

## Path parameters

- `id` string, uuid, required

## Response `200`

**ℹ️ Click to see full payload**

- CompanyMonitoringCheck
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `is_internal` boolean, required
  - `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired', required: ℹ️ Check status `expired` is deprecated and will be removed Q1'25. It will be replaced with an expired flag.
  - `type` 'company_monitoring', required
  - `subtype` string, nullable, required: Currently always null for `company_monitoring` Check
  - `last_activity_at` string, date-time, required: Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `data` CompanyMonitoringCheckDataDTO, required
    - `result` 'approved' | 'rejected' | 'error', nullable, required
    - `settings` CompanyMonitoringCheckDataSettingsDTO, required
      - `alert_categories` string[], required
    - `vendor` CompanyMonitoringCheckDataVendorDTO, required
      - `name` 'creditsafe', required
      - `is_monitored` boolean, required
    - `review` Review, required
      - `comment` string, nullable, required
      - `reviewed_at` string, date-time, nullable, required: Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
      - `reviewer_type` 'user' | 'system' | 'api', nullable, required
      - `user` NestedUser, required
        - `id` string, uuid, required
        - `first_name` string, required
        - `last_name` string, required
        - `email` string, email, required

## Other responses

- `400`: The request is either malformed or contain invalid parameters. - Make sure the identifier specified in the URL is a valid UUID
- `404`: No Company Monitoring check can be found.

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) - [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) - [OpenAPI document](https://skmtc.dev/dotfile/apis/api-specifications/revisions/50cab516e856?raw)