Skip to main content
POST
/
v1
/
alerts
/
lookup
curl -X POST "https://api.signa.so/v1/alerts/lookup" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ids": ["alt_01...", "alt_02..."] }'

{
  "object": "<string>",
  "data": [
    {}
  ],
  "request_id": "<string>"
}

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.

​
Overview

Polling pattern: when your webhook handler skips a delivery (offline, crash, hand-off between workers), persist the webhook-id values you’ve seen and reconcile by calling POST /v1/alerts/lookup to confirm end-to-end delivery. Org-scoped — alert IDs that belong to other orgs are silently dropped from the result (no information disclosure). Malformed or non-alt_* IDs are ignored.

​
Body Parameters

​
ids
string[]
required
1—100 alert IDs (alt_*).

​
Response

​
object
string
Always "list".
​
data
object[]
Array of Alert objects (order is not guaranteed to match input).
​
request_id
string
Request identifier.
curl -X POST "https://api.signa.so/v1/alerts/lookup" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ids": ["alt_01...", "alt_02..."] }'