GET /v1/monitors - SEC API for AI

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

{
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

List saved-search monitors for the current organization

Audience: application and coding agent.

Reading monitor state

The list is scoped to the authenticated organization. Each entry carries its saved query, filters, delivery configuration, active state, and lastCheckedAt; use those fields to distinguish a configured monitor from evidence of a completed delivery.

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"

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

Monitors POST /v1/monitors

​Reading monitor state

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Reading monitor state

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture