GET /v1/owners/13f - 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/owners/13f?cik=0001067983&limit=20"

{
  "object": "ownership_report",
  "managerName": "Example Manager",
  "form": "13F-HR",
  "filingDate": "2026-05-15",
  "reportDate": "2026-03-31",
  "accessionNumber": "0000000000-00-000000",
  "holdings": [{
    "issuer": "Example Issuer",
    "classTitle": "COM",
    "cusip": "000000000",
    "valueUsdThousands": 1200,
    "shares": 10000,
    "shareType": "SH"
  }],
  "provenance": { "source": "sec", "filingUrl": "https://www.sec.gov/Archives/..." },
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Return the latest normalized 13F ownership report for a manager CIK, with optional quarter-specific selection

Audience: application and coding agent.

Agent mode

Pass ?view=agent to receive the compact agent shape: manager name, form, filingDate, accessionNumber + lifted filingUrl + nested holdings[] capped to the first 50 positions and trimmed to 6 fields per position (issuer, cusip, valueUsdThousands, shares, shareType, putCall). holdingCount reports the parsed filing total, holdingsReturned reports the agent payload rows, and holdingsTruncated makes partial payloads explicit. Classes, investment discretion, and metadata envelopes are dropped. Typical reduction: ~35–45% depending on position count. See api conventions → response formats for the full ?view= contract.

Canonical metadata

requestId
traceparent
provenance
freshness
materialization

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/owners/13f?cik=0001067983&limit=20"

Example response

{
  "object": "ownership_report",
  "managerName": "Example Manager",
  "form": "13F-HR",
  "filingDate": "2026-05-15",
  "reportDate": "2026-03-31",
  "accessionNumber": "0000000000-00-000000",
  "holdings": [{
    "issuer": "Example Issuer",
    "classTitle": "COM",
    "cusip": "000000000",
    "valueUsdThousands": 1200,
    "shares": 10000,
    "shareType": "SH"
  }],
  "provenance": { "source": "sec", "filingUrl": "https://www.sec.gov/Archives/..." },
  "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

GET /v1/owners/13d-13g POST /v1/owners/13f/compare

​Agent mode

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Agent mode

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture