Skip to main content

​
Event Export

Use event export to inspect request, webhook, and stream event history outside the live API response path. SEC API supports filtered event listing and JSON or NDJSON exports.

​
Endpoints

  • GET /v1/events
  • GET /v1/events/export

​
Filtered event inspection

curl "$SECAPI_BASE_URL/v1/events?kind=event&type=artifact.created&requestId=req_123&limit=20" \
  -H "Authorization: Bearer $SECAPI_API_KEY"
Useful filters:
  • kind
  • type
  • requestId
  • since
  • limit

​
Export JSON

curl "$SECAPI_BASE_URL/v1/events/export?kind=event&limit=100&format=json" \
  -H "Authorization: Bearer $SECAPI_API_KEY"

​
Export NDJSON

curl "$SECAPI_BASE_URL/v1/events/export?kind=webhook_delivery&since=2026-03-14T00:00:00Z&format=ndjson" \
  -H "Authorization: Bearer $SECAPI_API_KEY"
Use NDJSON when downstream tooling needs line-oriented ingestion into log processors or audit and review tools.

​
CLI

secapi events list --kind event --request-id req_123 --limit 20
secapi events export --kind webhook_delivery --since 2026-03-14T00:00:00Z --format ndjson

​
Operational notes

  • exports are tenant-scoped
  • request correlation is driven by Request-Id
  • use exports when support asks for request, webhook, or stream history during troubleshooting