Skip to main content
GET
/
v1
/
alerts
List Alerts
curl --request GET \
  --url https://api.example.com/v1/alerts
{
  "object": "list",
  "data": [
    {
      "id": "alt_Qn6sU0vW",
      "watch_id": "wat_Nk3pR8sT",
      "watch_name": "AURORA brand watch",
      "trigger": "new_filing",
      "trademark": {
        "id": "tm_Yt9wX3zA",
        "mark_text": "AURORRA",
        "office_code": "uspto",
        "filing_date": "2026-03-20",
        "nice_classes": [9, 42],
        "owner": {
          "id": "own_Bv2xY4zC",
          "name": "Aurorra Labs LLC"
        }
      },
      "similarity_score": 0.91,
      "status": "unacknowledged",
      "created_at": "2026-03-22T08:15:00Z"
    },
    {
      "id": "alt_Rs7tV1wX",
      "watch_id": "wat_Nk3pR8sT",
      "watch_name": "AURORA brand watch",
      "trigger": "status_change",
      "trademark": {
        "id": "tm_Dw4yZ5aB",
        "mark_text": "AURORA HEALTH",
        "office_code": "euipo",
        "filing_date": "2026-03-18",
        "nice_classes": [35, 44],
        "owner": {
          "id": "own_Fx6zA7bD",
          "name": "Aurora Health Solutions GmbH"
        }
      },
      "similarity_score": 0.85,
      "status": "acknowledged",
      "created_at": "2026-03-19T14:22:00Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_nG3xY9zA"
}

​
Overview

Returns alerts generated by your watches when trademark events match your monitoring criteria. Each alert includes the matched trademark, the watch that triggered it, and a similarity score. Alerts can be filtered by watch, date range, and read status. Use this to power notification feeds, clearance review queues, and competitive intelligence dashboards.

​
Query Parameters

​
limit
integer
default:"20"
Items per page (max 100)
​
cursor
string
Pagination cursor from previous response
​
watch_id
string
Filter alerts to a specific watch (wat_*)
​
status
string
Filter by alert status: unacknowledged, acknowledged, dismissed
​
sort
string
default:"-created_at"
Sort field and direction

​
Response

​
data
object[]
{
  "object": "list",
  "data": [
    {
      "id": "alt_Qn6sU0vW",
      "watch_id": "wat_Nk3pR8sT",
      "watch_name": "AURORA brand watch",
      "trigger": "new_filing",
      "trademark": {
        "id": "tm_Yt9wX3zA",
        "mark_text": "AURORRA",
        "office_code": "uspto",
        "filing_date": "2026-03-20",
        "nice_classes": [9, 42],
        "owner": {
          "id": "own_Bv2xY4zC",
          "name": "Aurorra Labs LLC"
        }
      },
      "similarity_score": 0.91,
      "status": "unacknowledged",
      "created_at": "2026-03-22T08:15:00Z"
    },
    {
      "id": "alt_Rs7tV1wX",
      "watch_id": "wat_Nk3pR8sT",
      "watch_name": "AURORA brand watch",
      "trigger": "status_change",
      "trademark": {
        "id": "tm_Dw4yZ5aB",
        "mark_text": "AURORA HEALTH",
        "office_code": "euipo",
        "filing_date": "2026-03-18",
        "nice_classes": [35, 44],
        "owner": {
          "id": "own_Fx6zA7bD",
          "name": "Aurora Health Solutions GmbH"
        }
      },
      "similarity_score": 0.85,
      "status": "acknowledged",
      "created_at": "2026-03-19T14:22:00Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_nG3xY9zA"
}

​
Code Examples

curl "https://api.signa.so/v1/alerts?watch_id=wat_Nk3pR8sT&status=unacknowledged" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid query parameters
401unauthorizedMissing or invalid API key
404not_foundWatch ID does not exist (when filtering by watch_id)
429rate_limitedToo many requests