---
title: "Get alert"
method: GET
path: "/data-observability/v1/alerts/{alertUrn}"
tags: ["Alerts"]
---

# Get alert

`GET /data-observability/v1/alerts/{alertUrn}`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/data-observability/v1/alerts/{alertUrn}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/data-observability/v1/alerts/:alertUrn/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve an alert by URN, including the URNs of its findings.

URL-encode the alert URN when placing it in the request path. Each colon (`:`) becomes `%3A`.

If an alert groups more than 1000 findings, the `findingUrns` list is truncated. To get the findings
with their attributes, and with pagination, list them with the `alertUrn` parameter instead
(see [List findings](#tag/findings/GET/data-observability/v1/findings)).

## Path parameters

- `alertUrn` string, uri, required: URN of a Data Observability alert. Format: urn:ata:{tenant}:data-observability:alert:{uuid} Example: urn:ata:acme-corp:data-observability:alert:0197f3a0-1111-7c0c-8f9d-3a2b4c5d6e7f.

## Response `200`

The requested alert.

- AlertDetailResponse: An alert groups related findings, so your team handles one alert instead of many separate signals.
  - `urn` string, uri, required: URN of a Data Observability alert. Format: urn:ata:{tenant}:data-observability:alert:{uuid} Example: urn:ata:acme-corp:data-observability:alert:0197f3a0-1111-7c0c-8f9d-3a2b4c5d6e7f.
  - `status` string, required: @ExtensibleEnum The alert lifecycle status, taken from the findings: - `ACTIVE`: One or more of the alert's findings are still active. - `STALE`: None of the alert's findings are active, but one or more are stale. - `INACTIVE`: All of the alert's findings are inactive, and the alert has ended.
  - `severity` string, required: @ExtensibleEnum The highest severity among the alert's findings: `LOW`, `MEDIUM`, `HIGH`, or `CRITICAL`.
  - `resolution` string, required: @ExtensibleEnum How your team triaged the alert, as set in the web application: - `NOT_SET`: The resolution has not been decided yet. - `OPEN`: The alert requires attention. - `EXPECTED`: The behavior is acceptable and aligns with expectations. - `FALSE_POSITIVE`: The alert was triggered incorrectly and does not reflect a real problem. - `RESOLVED`: The underlying cause has been addressed. - `ESCALATED`: The alert has been escalated to Jira or ServiceNow. The resolution can change at any time, even after the alert has ended.
  - `createdAt` string, date-time, required: When the alert was created.
  - `updatedAt` string, date-time: When the alert's findings were last updated. The timestamp tracks updates to the findings only, not changes to the alert's resolution. The field cannot be filtered on. To detect resolution changes, re-fetch the alerts and compare fields.
  - `resolvedAt` string, date-time, nullable: When the alert was last resolved. Omitted while the alert is unresolved. The type still admits null so a future implementation may send it explicitly.
  - `findingUrns` FindingUrn[], required: The URNs of the findings grouped under the alert, capped at 1000 entries and not paginated. Returned by [Get alert](#tag/alerts/GET/data-observability/v1/alerts/{alertUrn}) only. If an alert groups more findings than that, the list is truncated. To get the findings with their attributes, and with pagination, list them with the `alertUrn` parameter instead (see [List findings](#tag/findings/GET/data-observability/v1/findings)). To retrieve a single finding, use [Get finding](#tag/findings/GET/data-observability/v1/findings/{findingUrn}).

## Other responses

- `400`: Bad request. The request parameters or body are invalid.
- `403`: Forbidden. You do not have permission to access the requested resource.
- `404`: Not found. The requested resource does not exist.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)