---
title: "Get observer by ID"
method: GET
path: "/v1/observers/{id}"
tags: ["Observer"]
---

# Get observer by ID

`GET /v1/observers/{id}`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/observers/{id}`
- Auth: HTTP bearer

Returns a single observer definition by its unique ID.

## Path parameters

- `id` string, required

## Response `200`

Observer found

- ObserverResponse: Observer definition returned by the portal API
  - `createdDate` string, date-time
  - `description` string
  - `id` string
  - `lastModifiedDate` string, date-time
  - `name` string
  - `observations` ObservationConfig[]
    - `alertingConfig` AlertConfig: Configuration that controls how observer alerts and warnings are evaluated
      - `alertLogic` 'AND' | 'OR'
      - `alertingMode` 'HYBRID' | 'CONFIDENCE_ONLY' | 'THRESHOLD_ONLY'
      - `ciAlertPercent` integer
      - `ciWarnPercent` integer
      - `comparisonMethod` 'LAST_VALUE' | 'MOVING_AVERAGE'
      - `sensitivity` integer
      - `thresholdAlertValue` number, double
      - `thresholdDuringLearning` boolean
      - `thresholdType` 'PERCENT' | 'RELATIVE' | 'ABSOLUTE'
      - `thresholdWarnValue` number, double
      - `trainingWindow` TrainingWindow: Training window used to establish observer alert baselines
        - `type` 'DAYS' | 'METRIC_POINTS'
        - `value` integer
      - `warnEnabled` boolean
      - `warnLogic` 'AND' | 'OR'
    - `evaluationType` 'NUMERIC' | 'TEMPORAL' | 'STRUCTURAL'
    - `excludedColumns` ExcludeColumn[]
      - `name` string
    - `metricTypeId` string
    - `observationKind` string
    - `significanceFilterValue` number, double
    - `significanceMode` 'PERCENTAGE_OF_VALUE' | 'ABSOLUTE_POINT'
    - `sourcingMode` 'SCHEDULE' | 'NONE'
    - `tags` string[]
    - `timeUnit` 'HOURS' | 'DAYS' | 'WEEKS'
    - `triggers` SchemaConfig[]
      - `enabled` boolean
      - `severity` 'WARN' | 'ALERT'
      - `triggerType` 'TABLE_DELETED' | 'COLUMN_DELETED' | 'COLUMN_ADDED' | 'TYPE_CHANGED' | 'COLUMN_RENAMED' | 'COLUMN_ORDER' | 'NULLABLE_CHANGED'
  - `status` 'ACTIVE' | 'INACTIVE' | 'PAUSED'
  - `targetAssetGroupId` string
  - `targeting` union
    - AssetGroupConfig: Observer targeting configuration for an asset group
      - `type` string
      - `assetGroupId` string
    - AssetIdConfig: Observer targeting configuration for a single asset
      - `type` string
      - `assetId` string

## Other responses

- `404`: Observer not found
- `500`: Internal server error

---

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