Skip to main content
GET
/
v1
/
alerts
/
{id}
Get Alert
curl --request GET \
  --url https://api.example.com/v1/alerts/{id}
{
  "id": "alt_abc123",
  "object": "alert",
  "watch_id": "wat_xyz789",
  "trademark_id": "tm_aurora01",
  "event_type": "filing",
  "severity": "high",
  "status": "unacknowledged",
  "summary": "New filing matching AURORA in class 9 (uspto)",
  "match_details": { "matched_term": "aurora", "score": 0.96 },
  "created_at": "2026-04-09T18:12:00Z",
  "acknowledged_at": null,
  "dismissed_at": null,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Returns the full record for a single alert, including the match details payload, the summary text, the watch and trademark it relates to, and any acknowledgement or dismissal state. Requires the portfolios:manage scope.

​
Path Parameters

​
id
string
required
Alert ID (alt_...).

​
Response

​
id
string
Alert ID.
​
object
string
Always alert.
​
watch_id
string
Parent watch ID (wat_...).
​
trademark_id
string
Trademark that triggered the alert (tm_...).
​
event_type
string
Event type that triggered the alert.
​
severity
string
Severity (high, medium, low, info).
​
status
string
Derived status (unacknowledged, acknowledged, dismissed).
​
summary
string
Human-readable summary line.
​
match_details
object
Detailed match payload from the watch criteria.
​
created_at
string
ISO 8601 creation timestamp.
​
acknowledged_at
string
ISO 8601 acknowledgement timestamp, if any.
​
dismissed_at
string
ISO 8601 dismissal timestamp, if any.
{
  "id": "alt_abc123",
  "object": "alert",
  "watch_id": "wat_xyz789",
  "trademark_id": "tm_aurora01",
  "event_type": "filing",
  "severity": "high",
  "status": "unacknowledged",
  "summary": "New filing matching AURORA in class 9 (uspto)",
  "match_details": { "matched_term": "aurora", "score": 0.96 },
  "created_at": "2026-04-09T18:12:00Z",
  "acknowledged_at": null,
  "dismissed_at": null,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl "https://api.signa.so/v1/alerts/alt_abc123" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid alert ID format
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundAlert does not exist or belongs to another org