> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Alert

> Get a single alert by ID

## Overview

Requires the `portfolios:manage` scope.

## Path Parameters

<ParamField path="id" type="string" required>Alert ID (`alt_*`).</ParamField>

## Response

Returns a single `Alert` (see [List Alerts](/api-reference/monitoring/alerts/list) for the shape).

## Errors

| Status | `type`      | When                                          |
| ------ | ----------- | --------------------------------------------- |
| 404    | `not_found` | Alert doesn't exist or belongs to another org |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/alerts/alt_4tYpL2Qn" \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";
  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const alert = await signa.alerts.retrieve("alt_4tYpL2Qn");
  ```
</CodeGroup>

<ResponseExample>
  ```json theme={null}
  {
    "id": "alt_4tYpL2Qn",
    "object": "alert",
    "schema_version": "2026-06-01",
    "watch": { "id": "wat_8kLm2nPq", "name": "Nike owner watch", "type": "owner" },
    "customer_reference": null,
    "event": {
      "type": "trademark.status_changed",
      "summary": "Status stage changed: published → registered",
      "diff": [
        { "path": "status_stage", "op": "changed", "from": "published", "to": "registered" }
      ]
    },
    "match": null,
    "trademark": {
      "id": "tm_9vXq3Rmt",
      "mark_text": "NIKE",
      "mark_feature_type": "word",
      "office_code": "US",
      "status": { "primary": "active", "stage": "registered" },
      "filing_date": "2024-02-01",
      "registration_date": "2026-07-01",
      "nice_classes": [25, 28],
      "owner_name": "Nike, Inc.",
      "as_of": "2026-07-05T09:10:00.000Z",
      "links": { "self": "/v1/trademarks/tm_9vXq3Rmt" }
    },
    "deadline": { "severity": "high", "opposition_window_status": "open", "must_act_by": "2026-09-04" },
    "timestamps": {
      "occurred_at": "2026-07-05T09:10:00.000Z",
      "ingested_at": "2026-07-05T09:12:00.000Z",
      "created_at": "2026-07-05T09:12:30.000Z"
    },
    "links": { "trademark": "/v1/trademarks/tm_9vXq3Rmt", "watch": "/v1/watches/wat_8kLm2nPq" },
    "evaluation_epoch": 0,
    "request_id": "req_3vXq7RmT"
  }
  ```
</ResponseExample>

## Related Endpoints

* [List Alerts](/api-reference/monitoring/alerts/list) - browse alerts with filters and pagination
* [Lookup Alerts](/api-reference/monitoring/alerts/lookup) - bulk-fetch alerts by ID
* [Watch Diagnostics](/api-reference/monitoring/watches/diagnostics) - explain why a specific trademark did or didn't alert