GET /v1/monitors/{monitor_id}/matches

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/monitors/mon_example_123/matches"

{
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Run the monitor’s saved query and return new matches since last_checked_at

Audience: application and coding agent.

Match window

This endpoint runs the saved query using the monitor’s current boundary and returns up to limit matches. It is an inspection read: unlike an internal monitor check, it does not advance lastCheckedAt. Do not treat an empty response as proof that no future scheduled check can find a match. For keyword monitors, lastCheckedAt becomes the filing-date lower bound. Structured monitor modes are availability-gated, so a disabled structured mode can produce no matches without proving that the underlying event type is absent.

Canonical metadata

requestId
traceparent

Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/monitors/mon_example_123/matches"

Example response

{
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff

POST /v1/monitors/{monitor_id}/delivery News

​Match window

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Match window

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture