GET /v1/artifacts/summary - 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/artifacts/summary"

{
  "object": "artifact_summary",
  "orgId": "org_example",
  "rows": [
    {
      "kind": "markdown_bundle",
      "status": "ready",
      "storageMode": "local",
      "totalBytes": 18432,
      "count": 3
    }
  ],
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Summarize persisted artifact storage for the current organization

Audience: developers checking the stored artifact footprint of their organization.

Coverage and source scope

Groups the current organization’s persisted artifacts by stored kind, lifecycle status, and storage mode. Counts and byte totals describe stored records, not source-filing coverage or external object-store completeness.

Canonical metadata

orgId
rows[].kind
rows[].status
rows[].storageMode
rows[].count
rows[].totalBytes
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/artifacts/summary"

Example response

{
  "object": "artifact_summary",
  "orgId": "org_example",
  "rows": [
    {
      "kind": "markdown_bundle",
      "status": "ready",
      "storageMode": "local",
      "totalBytes": 18432,
      "count": 3
    }
  ],
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

What the totals mean

Each row aggregates persisted records by kind, status, and storageMode for the current organization. totalBytes measures stored payload bytes; it is not a quota, billing statement, retention policy, or measure of source-filing completeness.

Errors

Without an organization on the authenticated principal, the route returns 403 organization_missing.

Give this prompt to your agent

Failure posture

retain orgId and requestId with an operational report
do not treat byte totals as a billing or retention guarantee
distinguish no aggregate rows from an assertion about historical filing coverage

POST /v1/artifacts/{artifact_id}/reconcile Board

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​What the totals mean

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

What the totals mean

Errors

Give this prompt to your agent

Failure posture